home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / btst240l.lzh / BT_REF.DOC < prev    next >
Text File  |  1989-09-04  |  124KB  |  2,611 lines
  1.           
  2.           
  3.           
  4.           
  5.           
  6.           ****   *         *      *             *******                 TM
  7.           *   *            *      *                *
  8.           *   *  *  * **   *   *  *   ***   *   *  *   ***   * **  *** **  
  9.           ****   *  **  *  *  *   *  *   *  *   *  *  *   *  **    *  *  * 
  10.           *   *  *  *   *  ***    *  ****   *   *  *  ****   *     *  *  * 
  11.           *   *  *  *   *  *  *   *  *      *   *  *  *      *     *  *  * 
  12.           ****   *  *   *  *   *  *   ****   ****  *   ****  *     *  *  * 
  13.                                                 *
  14.           Version 2.30 - Reference Guide        *        September 4, 1989
  15.                                              ***
  16.           
  17.           
  18.           
  19.           
  20.                   A Freely Available FidoNet Compatible Electronic
  21.                       Mail Interface and Dumb Terminal Package
  22.           
  23.           
  24.           
  25.           
  26.                  Software Written by Vince Perriello and Bob Hartman
  27.                      Documentation Written by Alan D. Applegate
  28.           
  29.           
  30.           
  31.           
  32.                   Copyright (C) 1988, 1989 Bit Bucket Software, Co.
  33.                                A Delaware Corporation
  34.                                  All Rights Reserved
  35.           
  36.                       Terms and Conditions Contained Separately
  37.           
  38.           
  39.           
  40.           
  41.                               Bit Bucket Software, Co.
  42.                             427-3 Amherst St., Suite 232
  43.                                   Nashua, NH 03063
  44.           
  45.           
  46.           
  47.           
  48.                         "BinkleyTerm" and "Freely Available"
  49.                      are trademarks of Bit Bucket Software, Co.
  50.           
  51.           
  52.           
  53.           
  54.           
  55.  
  56.               BinkleyTerm Version 2.30 - Reference Guide - Page 2
  57.  
  58.           TABLE OF CONTENTS
  59.           
  60.           Section 1 - General Information                             3
  61.                How to Use This Manual                                 3
  62.           
  63.           Section 2 - Configuring BinkleyTerm                         4
  64.                Configuration File                                     4
  65.                Scheduling Events                                      25
  66.           
  67.           Section 3 - General Reference Information                   32
  68.                Command Line Parameters                                32
  69.                Dial Translation                                       33
  70.                Response File Template                                 33
  71.                Scripts                                                35
  72.                Terminal Mode Keystrokes                               40
  73.                Unattended Mode Keystrokes                             43
  74.                VT-100 Keystrokes                                      46
  75.           
  76.           
  77.           
  78.           
  79.           
  80.           
  81.           
  82.           
  83.           
  84.           
  85.           
  86.           
  87.           
  88.           
  89.           
  90.           
  91.           
  92.           
  93.           
  94.           
  95.           
  96.           
  97.           
  98.           
  99.           
  100.           
  101.           
  102.           
  103.           
  104.           
  105.           
  106.           
  107.           
  108.           
  109.           
  110.           
  111.           
  112.  
  113.               BinkleyTerm Version 2.30 - Reference Guide - Page 3
  114.  
  115.           +-------------+
  116.           | +---------+ |
  117.           | | Section | |   BinkleyTerm Reference Guide
  118.           | |    1    | |   GENERAL INFORMATION
  119.           | +---------+ |
  120.           +-------------+
  121.           
  122.           HOW TO USE THIS MANUAL
  123.           
  124.           The documentation for BinkleyTerm is supplied in two parts.  
  125.           
  126.           The User's Guide (named BT_USER.DOC) explains how to install
  127.           BinkleyTerm.  It also describes basic operational procedures.  New
  128.           users may find some concepts or terminology unfamiliar; a glossary
  129.           is provided toward the end of the User's Guide.  
  130.           
  131.           Concepts and terminology that may be of interest to experienced
  132.           users and new users alike are covered in the Reference Guide (named
  133.           BT_REF.DOC) an alphabetically arranged manual separate from the
  134.           User's Guide. 
  135.           
  136.           For inquiries, questions or comments regarding BinkleyTerm, please
  137.           refer to the User's Guide section "BinkleyTerm Support." 
  138.           
  139.           
  140.                    
  141.                    
  142.           
  143.           
  144.           
  145.           
  146.           
  147.           
  148.           
  149.           
  150.           
  151.           
  152.           
  153.           
  154.           
  155.           
  156.           
  157.           
  158.           
  159.           
  160.           
  161.           
  162.           
  163.           
  164.           
  165.           
  166.           
  167.           
  168.           
  169.  
  170.               BinkleyTerm Version 2.30 - Reference Guide - Page 4
  171.  
  172.           +-------------+
  173.           | +---------+ |
  174.           | | Section | |   BinkleyTerm Reference Guide
  175.           | |    2    | |   CONFIGURING BINKLEYTERM
  176.           | +---------+ |
  177.           +-------------+
  178.           
  179.           CONFIGURATION FILE
  180.           
  181.           The BinkleyTerm configuration file, by default named BINKLEY.CFG,
  182.           is the place where you communicate information about your system
  183.           to BinkleyTerm.  Port number, modem control strings, FidoNet node
  184.           addresses, and much more are all contained in the configuration
  185.           file. 
  186.           
  187.           A sample configuration file comes with the BinkleyTerm 
  188.           distribution package.  The sample file is arranged in such a way
  189.           as to illustrate which parameters need to be changed for which
  190.           operational modes.  For ease of use as a reference, the parameters
  191.           are listed alphabetically here. 
  192.           
  193.           About <filespec>
  194.           
  195.                This tells BinkleyTerm the name of the ABOUT file, a special
  196.                file used with incoming file requests.  <filespec> is a
  197.                complete drive, path and filename designation.  Refer to the
  198.                User's Guide sections "File Requests" and "Security -
  199.                Controlling File Requests" for more information.
  200.           
  201.           Address [<zone>:]<net>/<node>[.<point>]
  202.           
  203.                This statement (or multiple statements) designates the network
  204.                address(es) of your system.  Although the <zone> and <point>
  205.                parameters are optional, it is recommended that the <zone>
  206.                parameter ALWAYS be used.
  207.           
  208.                When this statement is used, the older style (BinkleyTerm 2.00
  209.                and previous versions) addressing should NOT be used, such as
  210.                'Aka,' 'Point,' and 'Zone.'
  211.           
  212.                Multiple 'Address' statements, each with a different <zone>
  213.                parameter, may be used.  This allows BinkleyTerm to identify
  214.                itself differently to different zones, thereby making multi-
  215.                net operation somewhat more simple.  Note that in this
  216.                scenario, if you are connected to a zone for which an
  217.                'Address' statement does not exist, that the 'Address'
  218.                statement that appears first in the configuration file will
  219.                be used as a default.
  220.           
  221.                In addition, the zone given in the 'Address' statement that
  222.                appears first determines your "default" outbound area, as
  223.                given by the 'Hold' statement.  Mail for all other zones is
  224.                stored in distinct outbound areas for each zone.  See "Zone
  225.                Support" in the User's Guide for details.
  226.  
  227.               BinkleyTerm Version 2.30 - Reference Guide - Page 5
  228.  
  229.           
  230.                NOTE:  Point systems must also use the 'PrivateNet' statement,
  231.                even if a <point> parameter is specified.
  232.           
  233.           AfterMail <command_line>
  234.           
  235.                If used, BinkleyTerm will invoke a DOS shell and execute the
  236.                <command_line> after receiving mail.  It is suggested that
  237.                <command_line> designate a batch file, rather than a specific
  238.                program.  The batch file would contain command line(s) for the
  239.                program(s) that will actually unpack and/or toss incoming
  240.                mail.
  241.           
  242.                NOTE!  If this statement is used, no E2= or E3= exits during
  243.                event schedules should be used, since they take priority over
  244.                this statement.  Refer to the section "Scheduling Events" for
  245.                details.
  246.           
  247.                See also 'Packer' and 'Cleanup' for related information.
  248.           
  249.           Aka <net>/<node>
  250.           
  251.                NOTE:  This statement is supported for backward compatibility
  252.                only.  If you wish to specify a/k/a addresses, please use the
  253.                newer 'Address' statement described previously. 
  254.           
  255.                Allows nodes with more than one FidoNet address to specify
  256.                their alternate addresses.  This would normally be used by
  257.                network, region or zone coordinators, and other 'special'
  258.                nodes.  Multiple 'Aka' statements can be used.
  259.           
  260.           Answer <modem_string>
  261.           
  262.                When this statement is used, BinkleyTerm assumes that the
  263.                modem has been set NOT to answer the phone automatically (by
  264.                the modem initialization string, or the modem's DIP switches). 
  265.                When BinkleyTerm receives a response string of "RING" from the
  266.                modem, it sends the <modem_string> command to the modem to
  267.                answer the phone. 
  268.           
  269.                The advantage is that BinkleyTerm must be "alive and well"
  270.                before the modem will answer a call.  If for some reason
  271.                BinkleyTerm is not available, yet the modem still has power,
  272.                no calls will be answered.  
  273.           
  274.                NOTE!  Some modems DO NOT like commands to be sent while
  275.                they're sending response strings...in testing, this feature
  276.                DOES NOT work on all modems.  Only by trying it will you be
  277.                able to determine if it works with your modem.
  278.           
  279.           AnswerBack <text>
  280.           
  281.                In Terminal Mode, when an ENQ (ASCII decimal 5, hex 5) is
  282.                received, <text> will be sent in response.  Normal BinkleyTerm
  283.  
  284.               BinkleyTerm Version 2.30 - Reference Guide - Page 6
  285.  
  286.                character translations are available.  Many BBS packages send
  287.                this character immediately prior to requesting a user name.
  288.           
  289.           Application <app_name> [<parm> <parm> ... ]
  290.           
  291.                Allows addition of application dependent data to the
  292.                configuration file.  Any 'Application' statement is ignored
  293.                by BinkleyTerm entirely.
  294.           
  295.                <app_name> is the name of or reference to a specific
  296.                application, such as a message editor or outbound maintenance
  297.                utility that uses the BinkleyTerm configuration file.  Zero
  298.                or more application specific parameters, shown as <parm> in
  299.                the example, may follow <app_name>.  
  300.           
  301.           Autobaud
  302.           
  303.                In Unattended Mode, this forces BinkleyTerm to call out at the
  304.                baud rate specified by the 'Baud' statement, regardless of the
  305.                baud rate associated with a given nodelist entry.  This
  306.                assures connects at the highest possible baud rate.
  307.           
  308.           Avail <filespec>
  309.           
  310.                This designates the name of the file to be sent to a remote
  311.                system that file requests "FILES" from your system.  The
  312.                <filespec> identifies the file, and may contain an optional
  313.                drive and path designation.
  314.           
  315.                Refer to the User's Guide sections "File Requests" and
  316.                "Security - Controlling File Requests" for more information.
  317.           
  318.           Banner <string>
  319.           
  320.                The line designated by <string> is sent to callers 
  321.                immediately following the BinkleyTerm identification line, and
  322.                before the line, "Press <Escape> to enter BBS."  Generally,
  323.                this is the name of your BBS or something else of interest to
  324.                callers.
  325.                         
  326.           Baud <max_baud_rate>
  327.           
  328.                This parameter tells BinkleyTerm your maximum baud rate. 
  329.                Valid <max_baud_rate> settings are 300, 1200, 2400, 4800,
  330.                9600, 19,200 and 38,400.  In Terminal Mode, you may change
  331.                this setting. 
  332.           
  333.           BBS <exit_option>
  334.           
  335.                This designates the method to be used to access your BBS
  336.                software when a human caller dials your system.  Valid options
  337.                for <exit_option> are 'Batch,' 'Exit' and 'Spawn.'  Refer to
  338.                the User's Guide section "BBS Interface" for more information
  339.                on the options, and how to use them.
  340.  
  341.               BinkleyTerm Version 2.30 - Reference Guide - Page 7
  342.  
  343.           
  344.           BBSNote <string>
  345.           
  346.                After a human caller presses Escape to access the BBS program,
  347.                or after the number of seconds designated by the 'Timeout'
  348.                statement, BinkleyTerm will display the <string> to the
  349.                caller.  Generally, this is a notification that the BBS
  350.                software is loading. 
  351.           
  352.           Boss <net>/<node>
  353.           
  354.                NOTE:  This statement is supported for backward compatibility
  355.                only.  It is not needed when the 'Address' statement is used,
  356.                as described previously.
  357.           
  358.                This specifies a FidoNet node address.  For regular FidoNet
  359.                nodes, place your assigned address here.  For Point systems,
  360.                place the address of your Boss node here.
  361.           
  362.           BossPhone <phone_number>
  363.           
  364.                This parameter, used in Point installations, contains the
  365.                telephone number of your Boss node for use with the Alt-Y
  366.                command in Terminal Mode.  This statement is optional in all
  367.                cases except Point installations that do not wish to use a
  368.                nodelist.   
  369.           
  370.           BossPwd <password>
  371.           
  372.                Used for Point installations, this parameter designates the
  373.                password to be used for session-level passwording with your
  374.                Boss node.  Refer to the User's Guide section "Security -
  375.                Session Passwording" for additional information.  The Boss
  376.                node must also have session passwording implemented, using
  377.                this password.
  378.           
  379.                When this parameter AND 'BossPhone' are BOTH implemented, a
  380.                nodelist is NOT required for a Point system.
  381.           
  382.           BoxType <number>
  383.           
  384.                When full-screen mode is used (default), this tells
  385.                BinkleyTerm what type of boxes to use for the various on-
  386.                screen windows.  Legal values are from 0 to 4.  They produce
  387.                the following results (apologies given to people with printers
  388.                that do not support the extended IBM character set):
  389.           
  390.                     0    1    2    3    4        0 = Hatches (Non-IBM)
  391.                    +-+  םג™  חל†  שגà רלÕ       1 = Single Rule
  392.                    | |  ø ø  ´ ´  ´ ´  ø ø       2 = Double Rule
  393.                    +-+  ijגך  זל¶  צג©  קל®       3 = Single Top, Double Sides
  394.                                                  4 = Double Top, Single Sides
  395.           
  396.           
  397.  
  398.               BinkleyTerm Version 2.30 - Reference Guide - Page 8
  399.  
  400.           Busy <modem_string>
  401.           
  402.                While BinkleyTerm performs certain functions, and when you
  403.                exit the program from Unattended Mode, BinkleyTerm sends the
  404.                <modem_string> to the modem.  Normally, this is a short set
  405.                of modem commands, as shown in the sample configuration file,
  406.                to take the phone off-hook to prevent incoming calls.  Callers
  407.                will hear a busy signal.
  408.           
  409.                You may desire to lower DTR instead using a lower-case letter
  410.                "v."  This would cause callers to hear ringing, but with no
  411.                answer.  
  412.           
  413.           CaptureFile <filename>
  414.           
  415.                If used, this statement tells BinkleyTerm the name of a file
  416.                to use for session capturing in terminal mode.  The Alt-L
  417.                command toggles session capture on and off.  If this statement
  418.                is not used, then BinkleyTerm will prompt for a name each time
  419.                Alt-L is pressed.  When activated, all communications session
  420.                I/O will be echoed to this file.  The <filename> may
  421.                optionally include a drive and path designation as well.  
  422.           
  423.           Carrier <hex_carrier_mask>
  424.           
  425.                This tells BinkleyTerm which FOSSIL status bit it should use
  426.                to determine whether or not carrier is present.  A value of
  427.                80 (hexadecimal) is nearly always correct.  Some modems do not
  428.                support CD (carrier detect) and other signal lines may be
  429.                used.  
  430.           
  431.                NOTE:  This value is in HEXADECIMAL (base 16).  Other systems,
  432.                such as Opus-CBCS, ask for this value in DECIMAL (base 10). 
  433.                Normal setting is 80 hex, which equals 128 decimal. 
  434.           
  435.           Cleanup <command_line>
  436.           
  437.                If used, BinkleyTerm will execute <command_line> at the
  438.                beginning of each event, but prior to the 'Packer' statement's
  439.                command line (if used).  This might be used to unpack any
  440.                previously packed outbound mail for later repacking, or to
  441.                perform minor outbound area maintenance, etc.  It is suggested
  442.                that <command_line> designate a batch file that would contain
  443.                the command line(s) for the program(s) actually used to unpack
  444.                mail and/or perform maintenance.
  445.           
  446.                See also 'AfterMail' and 'Packer' for related information.
  447.           
  448.           Colors <border> <setting> <today> <pending> <activity> <trnsfr>
  449.           
  450.                Only applies if a Video FOSSIL (VFOSSIL) is detected at start-
  451.                up.  This statement allows setting of color attributes for the
  452.                full-screen windowed display.  The arguments are <border> for
  453.                the informational border area around the windows, and the
  454.  
  455.               BinkleyTerm Version 2.30 - Reference Guide - Page 9
  456.  
  457.                following color attributes: <setting> for the "Current
  458.                Settings" window, <today> for the "Today at a Glance" window,
  459.                <pending> for the "Pending Outbound Mail" window, <activity>
  460.                for the "Recent Activity" window, and <trnsfr> for the
  461.                "Transfer Status" window.  
  462.           
  463.                The default colors are all 7, black background with white
  464.                foreground.
  465.           
  466.                The following chart may assist you in determining your desired
  467.                color attribute values.  The numbers listed under "Foreground"
  468.                will yield the given color on a black background.  By adding
  469.                the value shown under "Background Value" to the foreground
  470.                value will yield a background of the selected color.  
  471.           
  472.                For example, to get yellow characters on a blue background,
  473.                add the foreground color for yellow, 14, to the background
  474.                value for blue, 16 - use a color attribute of 30.  
  475.           
  476.                Note that gray, bright colors and yellow cannot be used for
  477.                the background.
  478.           
  479.                Color          Foreground     Background Value
  480.                -------------- -------------- ----------------
  481.                Black          0              0
  482.                Blue           1              16
  483.                Green          2              32
  484.                Cyan           3              48
  485.                Red            4              64
  486.                Magenta        5              80
  487.                Brown          6              96
  488.                White          7              112
  489.                Gray           8              N/A
  490.                Bright Blue    9              N/A
  491.                Bright Green   10             N/A
  492.                Bright Cyan    11             N/A
  493.                Bright Red     12             N/A
  494.                Bright Magenta 13             N/A
  495.                Yellow         14             N/A
  496.                Bright White   15             N/A
  497.           
  498.                On IBM-compatible monochrome displays and using a black
  499.                background, colors 9 through 15 yield high intensity
  500.                characters, 1 through 7 normal intensity characters.  0 and
  501.                8 yield invisible characters.  1 and 9 will yield underscored
  502.                characters.
  503.           
  504.           CursorCol <column>
  505.           
  506.                For use with multi-tasking systems, this tells BinkleyTerm
  507.                the column number to place the cursor after screen writes. 
  508.                For DESQview, <column> should be set to 1.  The default value
  509.                is 80.  
  510.           
  511.  
  512.               BinkleyTerm Version 2.30 - Reference Guide - Page 10
  513.  
  514.           CursorRow <row>
  515.           
  516.                For use with multi-tasking systems, this tells BinkleyTerm the
  517.                row number to place the cursor after screen writes.  For
  518.                DESQview, <row> should be set to 1.  The default value is 23.
  519.           
  520.           Dial <match_string> <new_prefix>/[<new_suffix>]
  521.           
  522.                This option allows for real-time telephone number translation. 
  523.                
  524.                BinkleyTerm will look at the telephone number it is to send
  525.                to the modem.  If the prefix of the telephone number matches
  526.                that shown in <match_string>, then the prefix will be changed
  527.                to <new_prefix>, and <new_suffix> (optional) will be added to
  528.                the end. 
  529.                    
  530.                In most cases, this will be used to strip-off "1-" and/or area
  531.                codes for systems in a local exchange, such as:
  532.           
  533.                DIAL 1-603-888 888/
  534.                    
  535.                A number in the nodelist as 1-603-888-8179 would be changed
  536.                to simply 888-8179 and dialed.           
  537.           
  538.                DIAL 1-303-555 555/&M0
  539.                    
  540.                A number in the nodelist as 1-303-555-1234 would be changed
  541.                to 555-1234&M0 and dialed. 
  542.           
  543.                There is a maximum of 20 characters each for <match_string>,
  544.                <new_prefix> and <new_suffix>.
  545.           
  546.                Another use for this feature would be for dialing scripts:  
  547.                        
  548.                DIAL 1-404 "GA_PCP.SCR"404/
  549.                    
  550.                This line could be used to invoke a PC Pursuit script, for
  551.                example, for the state of Georgia.  The script would be used
  552.                for all outgoing calls to area code 404. 
  553.                    
  554.                For permanent translations it is probably more efficient to
  555.                perform these translations with your nodelist processing
  556.                program (i.e., XlatList, ParseLst, XlaxNode).  Refer to your
  557.                nodelist processing software documentation for more
  558.                information.
  559.           
  560.           DoingMail <string>
  561.           
  562.                If used, this statement will cause BinkleyTerm to send
  563.                <string> to a caller when an event without a 'B' flag is
  564.                active, indicating that BBS access is NOT allowed.  This
  565.                replaces the default string "Processing Mail.  Please hang
  566.                up."  See the section "Scheduling Events" for more information
  567.                on event flags.
  568.  
  569.               BinkleyTerm Version 2.30 - Reference Guide - Page 11
  570.  
  571.           
  572.           Downloads <path>
  573.           
  574.                This tells BinkleyTerm where to place files downloaded while
  575.                in Terminal Mode.  The <path> is a complete drive and path
  576.                designation.  This path has no effect on mail transfers made
  577.                in Unattended Mode.
  578.           
  579.           DTRHigh
  580.           
  581.                If used, BinkleyTerm will leave the DTR (data terminal ready)
  582.                line to the modem "high" whenever it is exiting.  By default,
  583.                BinkleyTerm takes the DTR line "low" when exiting.  The use
  584.                of 'DTRHigh' has no effect when doing an Alt-J shell escape
  585.                which will leave DTR low.  'DTRHigh' should be used with
  586.                modems that go back on-hook when DTR is lowered.
  587.           
  588.           EnterBBS <string>
  589.           
  590.                If used, this statement will cause BinkleyTerm to send
  591.                <string> to a caller when the BBS is available, during events
  592.                with a 'B' flag, indicating that BBS access is allowed.  This
  593.                replaces the default string "Press <Escape> to enter BBS." 
  594.                Note that <string> must not exceed one line.  See the section
  595.                "Scheduling Events" for more information on event flags.
  596.           
  597.           Event <event_flags...>
  598.           
  599.                NOTE!  Normally the 'Event' statement is used only in the
  600.                event file, BINKLEY.EVT.  Events should NOT be scheduled in
  601.                the configuration file.  This statement begins an event line. 
  602.                Due to the depth of this topic, it is covered in the section
  603.                "Scheduling Events."
  604.           
  605.           ExtrnMail [<errorlevel>] <string> 
  606.           
  607.                This is used in conjunction with BinkleyTerm's external mail
  608.                program feature.  If while waiting for a YooHoo or TSYNC (the
  609.                beginning of a FidoNet mail session) BinkleyTerm receives
  610.                <string>, it will write to the disk a file named MAILBAT.BAT,
  611.                and will then exit with an errorlevel of 99.  Refer to the
  612.                User's Guide section "External Mail Programs" for information.
  613.           
  614.                Note that if the [<errorlevel>] parameter is used, BinkleyTerm
  615.                will exit with an errorlevel of the value given, rather than
  616.                the default value of 99.
  617.           
  618.                When used for an external mail program, <string> should be
  619.                relatively long, without too many repeating characters, to
  620.                assure accuracy.  When used with multiple BBS functionality,
  621.                <string> may be only one letter.
  622.           
  623.                Up to 16 "ExtrnMail" statements that each use [<errorlevel>]
  624.                may be used.
  625.  
  626.               BinkleyTerm Version 2.30 - Reference Guide - Page 12
  627.  
  628.           
  629.           Gong
  630.           
  631.                Using this statement causes BinkleyTerm to sound an alarm when
  632.                it successfully connects with a system it's attempting dial,
  633.                or after a download has been completed.  'Gong' is only
  634.                applicable in Terminal Mode.  Note that 'Gong' also works when
  635.                doing a manual mail poll operation in Terminal Mode (Alt-M).
  636.           
  637.           Hold <path>
  638.           
  639.                This specifies the complete drive and path designation for the
  640.                directory that will be used as your outbound mail holding
  641.                area.  oMMM and/or other mail processing software places
  642.                outbound mail in this area for BinkleyTerm to send to or hold
  643.                for other FidoNet systems.
  644.           
  645.                It should be mentioned that this area should NOT contain any
  646.                other files of any kind, and that the contents of the
  647.                directory should NOT be manipulated by you unless you know
  648.                EXACTLY what you're doing.  For all practical purposes,
  649.                BinkleyTerm maintains this directory for you.
  650.           
  651.           Include <filename>
  652.           
  653.                If used, this tells BinkleyTerm the name of a file to include
  654.                while reading the configuration file.  The include file must
  655.                contain additional configuration file statements in the same
  656.                format as expected for the primary configuration file.  When
  657.                end-of-file is reached, BinkleyTerm will continue reading the
  658.                main configuration file at the line immediately following the
  659.                "Include" statement that initially caused BinkleyTerm to
  660.                branch.
  661.           
  662.                The <filename> may optionally include a drive and path
  663.                designation.  Example:  C:\BT\INCL_2.CFG
  664.           
  665.           Init <modem_string>
  666.           
  667.                BinkleyTerm sends the <modem_string> to the modem to 
  668.                initialize it, and make it ready for communication.  The
  669.                string is sent to the modem verbatim, with the exception of
  670.                special dial translation characters.  These characters are
  671.                shown in the section "Dial Translations." 
  672.           
  673.                Refer to your modem instruction manual for help in finding a
  674.                correct init string for your particular modem and
  675.                configuration.
  676.           
  677.           KnownAbout <filespec>
  678.           
  679.                This tells BinkleyTerm the name of the ABOUT file, a special
  680.                file used with incoming file requests.  <filespec> is a
  681.                complete drive, path and filename designation.  This ABOUT
  682.  
  683.               BinkleyTerm Version 2.30 - Reference Guide - Page 13
  684.  
  685.                file applies only to file requests that are received from
  686.                "known" systems.  
  687.           
  688.                Refer to the User's Guide sections "File Requests" and
  689.                "Security - Controlling File Requests" for more information.
  690.           
  691.           KnownAvail <filespec>
  692.           
  693.                This designates the name of the file to be sent to a "known"
  694.                remote system which file requests "FILES" from you.  The
  695.                <filespec> identifies the file, and may contain an optional
  696.                drive and path designation.
  697.           
  698.                Refer to the User's Guide sections "File Requests" and
  699.                "Security -Controlling File Requests" for more information.
  700.           
  701.           KnownInbound <path>
  702.           
  703.                Used with secured inbound areas, this statement designates the
  704.                path to the inbound file area used for mail received from
  705.                "known" systems.
  706.           
  707.                Refer to the User's Guide section "Security - Secured Inbound
  708.                File Areas" for more information.
  709.           
  710.           KnownReqLim <quantity>
  711.           
  712.                This tells BinkleyTerm the maximum number of files that will
  713.                be sent in response to incoming file requests during any one
  714.                mail session.  Regardless of whether the incoming requests has
  715.                wildcards, or whether multiple file requests are sent in one
  716.                mail session, the maximum number of files that will be sent
  717.                in response to an incoming file request will be no greater
  718.                than <quantity>.  
  719.           
  720.                This statement applies only to "known" systems.
  721.           
  722.                Refer to the User's Guide sections "File Requests" and
  723.                "Security - Controlling File Requests" for more information.
  724.           
  725.           KnownReqList <filespec>
  726.           
  727.                This designates the name of the OKFILE, a special used with
  728.                incoming file requests.  The <filespec> is a complete drive,
  729.                path and filename designation.  This OKFILE applies only to
  730.                file requests received from "known" systems.
  731.           
  732.                For more information, refer to the User's Guide sections "File
  733.                Requests" and "Security - Controlling File Requests."
  734.           
  735.           KnownReqTpl <filespec>
  736.           
  737.                This designates the name of the response file template used
  738.                for request response file construction.  The <filespec> is a
  739.  
  740.               BinkleyTerm Version 2.30 - Reference Guide - Page 14
  741.  
  742.                complete drive, path and filename designation.  This template
  743.                applies only for response files generated for "known" systems.
  744.           
  745.                For more information, refer to the User's Guide sections
  746.                "Request Response Files" and "Security - Response File
  747.                Templates."
  748.           
  749.           LockBaud
  750.           
  751.                This configuration file statement is provided for backwards
  752.                compatibility, but is considered obsolete.  You should lock
  753.                the FOSSIL driver baud rate instead.
  754.           
  755.           LogLevel <log_level_number>
  756.           
  757.                This tells BinkleyTerm how verbose to make the status log. 
  758.                Acceptable values for <log_level_number> are from 1 to 5, 1
  759.                indicating minimal information, 5 maximum information.  See
  760.                the 'Statuslog' option for additional information.
  761.           
  762.                Each log entry is preceded by a character or a blank,
  763.                indicating the importance of the entry.
  764.           
  765.                LogLevel  Characters That Precede Included Entries
  766.           
  767.                     1      ! *
  768.                     2      ! * +
  769.                     3      ! * + :
  770.                     4      ! * + : #
  771.                     5      ! * + : # and blank (no character)
  772.           
  773.           Macro <number> <macro_string>
  774.           
  775.                This allows the sending of predefined macros from within
  776.                Terminal Mode.  Macros are typically used to send your name,
  777.                user ID, or passwords while on-line.
  778.           
  779.                The <number> parameter is a digit between 1 and 9, which
  780.                corresponds to the F1 through F9 keys.  While in Terminal
  781.                Mode, you send a macro by pressing Alt-Fx, x indicating the
  782.                macro number you desire to send.
  783.           
  784.                The <macro_string> is sent verbatim.  A carriage return is
  785.                indicated by the pipe symbol (|).  No other translations take
  786.                place.
  787.           
  788.           MailNote <string>
  789.           
  790.                Used in conjunction with BinkleyTerm's external mail program
  791.                feature.  When the string designated by the 'ExtrnMail'
  792.                statement is received, <string> is sent to the caller as
  793.                notification that the external mail program is being loaded. 
  794.                Refer to the User's Guide section "External Mail Programs" for
  795.                information.
  796.  
  797.               BinkleyTerm Version 2.30 - Reference Guide - Page 15
  798.  
  799.           
  800.           MaxPort <quantity>
  801.           
  802.                BinkleyTerm is capable of supporting up to 32 communications
  803.                ports.  This is, however, far more than any current FOSSIL
  804.                driver is capable of supporting.  Normally the <quantity> will
  805.                be 1 or 2, depending on your FOSSIL.
  806.           
  807.                Refer to the documentation for your FOSSIL for information
  808.                about the number of ports it is capable of supporting.  For
  809.                Unattended Mode, the port number in use is set by the 'Port'
  810.                statement.  In terminal mode, you may change the port in use,
  811.                dependent on this statement, the number of ports your FOSSIL
  812.                can support, and the hardware you have available. 
  813.           
  814.           MaxReq <quantity>
  815.           
  816.                This tells BinkleyTerm the maximum number of files that will
  817.                be sent in response to incoming file requests during any one
  818.                mail session.  Regardless of whether the incoming requests has
  819.                wildcards, or whether multiple file requests are sent in one
  820.                mail session, the maximum number of files that will be sent
  821.                in response to an incoming file request will be no greater
  822.                than <quantity>. 
  823.           
  824.                Refer to the User's Guide sections "File Requests" and
  825.                "Security - Controlling File Requests" for more information.
  826.           
  827.           ModemTrans <number> <prefix>/[<suffix>]
  828.           
  829.                This statement allows BinkleyTerm to dynamically select the
  830.                modem prefix and suffix strings based on the modem type field
  831.                found in a Version 6 or compatible nodelist, or in a
  832.                NODELIST.EXT file (see the section "Nodelist" in the User's
  833.                Guide).  
  834.           
  835.                The <prefix>/[<suffix>] have the same purpose and usage as
  836.                they do in conjunction with the 'Dial' statement described
  837.                previously.  Refer to 'Dial' above for more information.
  838.           
  839.                The value of <number> corresponds to a given modem type.  If
  840.                this type is matched, then the given <prefix>/[<suffix>]
  841.                values are used.  Possible values currently are:
  842.           
  843.                     <number>  Nodelist Modem Flag Set
  844.                     --------- ---------------------------------
  845.                     1         HST
  846.                     2         PEP
  847.                     3         Either HST or PEP
  848.                     4         Not Currently Used by BinkleyTerm
  849.           
  850.           MultiLink
  851.           
  852.                This tells BinkleyTerm that the MultiLink multi-tasker is
  853.  
  854.               BinkleyTerm Version 2.30 - Reference Guide - Page 16
  855.  
  856.                installed, and to release time-slice to the multi-tasker
  857.                during certain non-processor-intensive operations.  This
  858.                increases system efficiency for MultiLink-using systems.
  859.           
  860.           NetFile <path>
  861.           
  862.                This specifies the complete drive and path of the directory
  863.                that will hold files being sent to your system via FidoNet. 
  864.                Incoming mail is stored here prior to processing.  This path
  865.                is also used by BTCTL to create a MAIL.SYS file. 
  866.           
  867.                If secured inbound areas are being used (see 'ProtInbound' and
  868.                'KnownInbound' in this Reference Guide, or the section
  869.                "Security - Secured Inbound File Areas" in the User's Guide),
  870.                then this statement designated the inbound file path for mail
  871.                received from systems not in the nodelist and not password
  872.                protected.
  873.           
  874.           NetMail <path>
  875.           
  876.                This specifies the complete drive and path of the directory
  877.                that contains a Fido compatible message base.
  878.           
  879.                Note that this directory is not used by BinkleyTerm itself. 
  880.                This path is used to build a MAIL.SYS file when the BTCTL
  881.                program is run.  MAIL.SYS is produced for the benefit of
  882.                certain mail processing utilities.
  883.           
  884.           NewNodelist
  885.           
  886.                This statement tells BinkleyTerm that it is to use a "New Opus
  887.                Style" Version 6 nodelist.  The files NODELIST.IDX and
  888.                NODELIST.DAT will be expected, and must be compiled and ready
  889.                for use by BinkleyTerm.  Refer to the User's Guide section
  890.                "Nodelist" for more information. 
  891.           
  892.           NoCollide
  893.           
  894.                By default, BinkleyTerm will make an attempt to detect an
  895.                incoming call while preparing to make an outgoing call, and
  896.                abort the outgoing call process.  This feature is called "call
  897.                collision detection," and may not work on all modems.  Using
  898.                'NoCollide' disables this feature entirely.
  899.           
  900.           Nodelist <path>
  901.           
  902.                This specifies the complete drive and path where processed,
  903.                compiled nodelist files can be found.  Refer to the User's
  904.                Guide section "Nodelist" for more information.
  905.           
  906.           NoFullScreen
  907.           
  908.                By default, BinkleyTerm uses a full-screen interface when in
  909.                Unattended Mode.  When this statement is used, BinkleyTerm
  910.  
  911.               BinkleyTerm Version 2.30 - Reference Guide - Page 17
  912.  
  913.                will use the line-by-line screen write mode employed by
  914.                BinkleyTerm Version 1.10 and earlier.  This statement has no
  915.                effect in Terminal Mode.
  916.                    
  917.           NoPickup
  918.           
  919.                This statement tells BinkleyTerm that during mail sessions,
  920.                it should only deliver mail, and refuse to pickup any mail
  921.                that may be waiting for your system.
  922.           
  923.           NoRequests
  924.           
  925.                This statement tells BinkleyTerm to universally refuse
  926.                incoming file requests at all times.
  927.           
  928.           NoSLO
  929.           
  930.                This tells BinkleyTerm NOT to employ SEAlink "Overdrive" (an
  931.                ACK-less variety of the SEAlink protocol) for any SEAlink
  932.                network mail transfers.  
  933.           
  934.           NoWaZOO
  935.           
  936.                Forces BinkleyTerm to be strictly an FSC-0001 mailer by
  937.                disabling WaZOO functionality.  This is primarily of interest
  938.                to coordinators who wish to verify that their nodes are
  939.                meeting FidoNet compatibility requirements.
  940.           
  941.                There is no benefit to the average user from using this
  942.                statement.  In fact, performance with other WaZOO-capable
  943.                mailers (BinkleyTerm, Opus, D'Bridge, FrontDoor, etc.) will
  944.                be adversely affected.
  945.           
  946.           NoZones
  947.           
  948.                Tells BinkleyTerm to handle zones in the same manner as
  949.                version 1.50 and previous versions.  This essentially means
  950.                that multi-zone support is turned off.  Refer to the User's
  951.                Guide section "Zone Support" for additional information.
  952.           
  953.           Okfile <filespec>
  954.           
  955.                This designates the name of the OKFILE, a special file used
  956.                with incoming file requests.  <filespec> is a complete drive,
  957.                path and filename designation.  
  958.           
  959.                For more information, refer to the User's Guide sections "File
  960.                Requests" and "Controlling File Requests."
  961.           
  962.           Overwrite
  963.           
  964.                When receiving a file in Unattended Mode, or when  downloading
  965.                a file in Terminal Mode, BinkleyTerm by default will NOT allow
  966.                overwriting of an existing file if you're receiving a file
  967.  
  968.               BinkleyTerm Version 2.30 - Reference Guide - Page 18
  969.  
  970.                with the same name.  Instead, BinkleyTerm will slightly alter
  971.                the name of the file being received to differentiate it from
  972.                the existing file.  By using the 'Overwrite' statement,
  973.                BinkleyTerm WILL ALLOW overwriting of existing files should
  974.                you be receiving one by the same name.
  975.           
  976.                Use this option carefully. 
  977.           
  978.           Packer <command_line>
  979.           
  980.                If used, BinkleyTerm will execute <command_line> at the
  981.                beginning of each event, but after the "Cleanup" statement's
  982.                command line (if used).  This might be used to pack any
  983.                pending outbound mail for sending.  It is suggested that
  984.                <command_line> designate a batch file that would contain the
  985.                command line(s) for the program(s) actually used to scan
  986.                and/or pack mail.
  987.           
  988.                See also 'AfterMail' and 'Cleanup' for related information.
  989.           
  990.           Point <net>/<node>
  991.           
  992.                NOTE:  This statement is supported for backward compatibility
  993.                only.  To specify a system address, use the 'Address'
  994.                statement described previously.
  995.           
  996.                This parameter specifies a FidoNet node address.  For regular
  997.                FidoNet nodes, this is your assigned node address.  For Point
  998.                systems, this address is the one assigned to you by your Boss
  999.                node Sysop.
  1000.           
  1001.           PollTries <number>
  1002.           
  1003.                This controls how many call attempts BinkleyTerm will make
  1004.                under the following circumstances:
  1005.           
  1006.                     - Alt-D keypress in Terminal Mode
  1007.                     - Alt-M keypress in Terminal or Unattended Mode
  1008.                     - BT POLL command line invocation of BinkleyTerm
  1009.           
  1010.                BinkleyTerm will make <number> attempts, then stop.
  1011.           
  1012.           Port <port_number>
  1013.           
  1014.                This informs BinkleyTerm which communications port your modem
  1015.                is connected to or configured as.  The <port_number>
  1016.                corresponds to the COM port number, 1 for COM1, 2 for COM2,
  1017.                etc.  Most FOSSIL drivers support up to 2 COM ports, COM1 and
  1018.                COM2, some support more.  Refer to your FOSSIL documentation
  1019.                for information on port support and installation information. 
  1020.           
  1021.                Note that in Terminal Mode, it is possible to override this
  1022.                setting.
  1023.           
  1024.  
  1025.               BinkleyTerm Version 2.30 - Reference Guide - Page 19
  1026.  
  1027.           PreDial <modem_string>
  1028.           
  1029.                The <modem_string> designates a string, which will have
  1030.                standard modem translations performed upon it, that is to be
  1031.                sent to the modem BEFORE the dial string (designated by the
  1032.                'Prefix' statement) is sent.  BinkleyTerm has a default
  1033.                'PreDial' string of:
  1034.           
  1035.                     v``^`````
  1036.           
  1037.                Some modems give responses when DTR is lowered, and others
  1038.                require an extended period of time to resync.  By using
  1039.                'PreDial,' you can override the default to provide an outward
  1040.                dialing situation better suited to your modem.  In testing,
  1041.                a single backquote (`) has been used with the USR HST high
  1042.                speed modem to provide extremely fast outward dialing
  1043.                responsiveness.
  1044.           
  1045.           Prefix <modem_string>
  1046.           
  1047.                The <modem_string> is a modem command to cause the modem to
  1048.                dial.  To dial a system, BinkleyTerm sends the <modem_string>,
  1049.                followed by the telephone number, to the modem.  Normally, for
  1050.                touch-tone systems, "ATDT," is used, for rotary-dial lines,
  1051.                "ATDP," would be used.
  1052.           
  1053.                Refer to your modem manual for more information on control
  1054.                options. 
  1055.           
  1056.           PreInit <modem_string>
  1057.           
  1058.                The <modem_string> designates a string, which will have
  1059.                standard modem translations performed upon it, that is to be
  1060.                sent to the modem BEFORE the modem initialization string
  1061.                (designated by the 'Init' statement) is sent.  BinkleyTerm
  1062.                has a default 'PreInit' string of:
  1063.           
  1064.                     |v~^````` |`````
  1065.           
  1066.                The default string is optimized to be suitable for a wide
  1067.                variety of modems.  However, many modems may be able to work
  1068.                with a shorter string, which would yield faster modem
  1069.                initialization sequences.  In testing, this 'PreInit' string
  1070.                has proven effective:
  1071.           
  1072.                     |v``^``
  1073.           
  1074.                Using this string, the initialization sequence is very fast. 
  1075.                Note that 1/2 second is still added at the end of the
  1076.                'PreInit' string for timing purposes, and therefore, 1/2
  1077.                second is the fastest initialization that could be realized
  1078.                by using your own 'PreInit' setting.
  1079.           
  1080.           
  1081.  
  1082.               BinkleyTerm Version 2.30 - Reference Guide - Page 20
  1083.  
  1084.           PrivateNet <net>
  1085.           
  1086.                This tells BinkleyTerm the net number of a private network for
  1087.                which you serve as a gateway, if any.  This statement is also
  1088.                used on Point systems to designate their private net number. 
  1089.                
  1090.                When this parameter is used, Point systems you support may
  1091.                poll you with a complete Point address to pick-up any waiting
  1092.                mail.  Please note that the mail must still be addressed to
  1093.                the private address assigned to the Point, as Point addressing
  1094.                is not taken into consideration in the naming of outbound
  1095.                mail.  
  1096.           
  1097.           ProtAbout <filespec>
  1098.           
  1099.                This tells BinkleyTerm the name of the ABOUT file, a special
  1100.                file used with incoming file requests.  The <filespec> is a
  1101.                complete drive, path and filename designation.  This ABOUT
  1102.                file applies only to file requests that are received from
  1103.                "protected" systems.
  1104.           
  1105.                Refer to the User's Guide sections "File Requests" and
  1106.                "Security - Controlling File Requests" for more information.
  1107.           
  1108.           ProtAvail <filespec>
  1109.           
  1110.                This designates the name of the file to be sent to a
  1111.                "protected" remote system which file requests "FILES" from
  1112.                you.  The <filespec> identifies the file, and may contain an
  1113.                optional drive and path designation.
  1114.           
  1115.                Refer to the User's Guide sections "File Requests" and
  1116.                "Security - Controlling File Requests" for more information.
  1117.           
  1118.           ProtInbound <path>
  1119.           
  1120.                Used with secured inbound areas, this statement designates the
  1121.                path to the inbound file area used for mail received from
  1122.                "protected" systems.  
  1123.           
  1124.                Refer to the User's Guide section "Security - Secured Inbound
  1125.                File Area" for more information.
  1126.           
  1127.           Protocol <filespec>
  1128.           
  1129.                This tells BinkleyTerm that it can use the listed external
  1130.                file transfer protocol within Terminal Mode.  The <filespec>
  1131.                is a complete drive, path and filename that points to an Opus-
  1132.                CBCS compatible external file transfer protocol program. 
  1133.                Refer to the User's Guide section "External Protocols" for
  1134.                more information.
  1135.           
  1136.                Note that the first letter of <filespec> will be the letter
  1137.                used to access the protocol from the upload and download menus
  1138.  
  1139.               BinkleyTerm Version 2.30 - Reference Guide - Page 21
  1140.  
  1141.                in Terminal Mode.  Because the first letter of the filename
  1142.                may conflict with another external protocol, or with a hard-
  1143.                coded protocol, you may need to rename the executable file for
  1144.                the external protocol to begin with a letter that is not
  1145.                currently in use.
  1146.           
  1147.                Note also that external protocols are available in Terminal
  1148.                Mode ONLY - they cannot be used for mail session in Unattended
  1149.                Mode!
  1150.           
  1151.           ProtReqLim <quantity>
  1152.           
  1153.                This tells BinkleyTerm the maximum number of files that will
  1154.                be sent in response to incoming file requests during any one
  1155.                mail session.  Regardless of whether the incoming requests has
  1156.                wildcards, or whether multiple file requests are sent in one
  1157.                mail session, the maximum number of files that will be sent
  1158.                in response to an incoming file request will be no greater
  1159.                than <quantity>.  
  1160.           
  1161.                This statement applies only to file requests that are received
  1162.                from "protected" systems. 
  1163.           
  1164.                Refer to the User's Guide sections "File Requests" and
  1165.                "Security - Controlling File Requests" for more information.
  1166.           
  1167.           ProtReqList <filespec>
  1168.           
  1169.                This designates the name of the OKFILE, a special used with
  1170.                incoming file requests.  <filespec> is a complete drive, path
  1171.                and filename designation.  This OKFILE applies only to file
  1172.                requests received from "protected" systems.
  1173.           
  1174.                For more information, refer to the User's Guide sections "File
  1175.                Requests" and "Security - Controlling File Requests."
  1176.           
  1177.           ProtReqTpl <filespec>
  1178.           
  1179.                This designates the name of the response file template used
  1180.                for request response file construction.  The <filespec> is a
  1181.                complete drive, path and filename designation.  This template
  1182.                applies only for response files generated for "protected"
  1183.                systems.
  1184.           
  1185.                For more information, refer to the User's Guide sections
  1186.                "Request Response Files" and "Security - Response File
  1187.                Templates."
  1188.           
  1189.           QuickNodelist
  1190.           
  1191.                This tells BinkleyTerm to use a QuickBBS 2.0x nodelist.  This
  1192.                nodelist must not be produced by QuickBBS' Qnode program, as
  1193.                it WILL NOT work correctly for BinkleyTerm as of this writing. 
  1194.                A current version of ParseLst is the recommended nodelist
  1195.  
  1196.               BinkleyTerm Version 2.30 - Reference Guide - Page 22
  1197.  
  1198.                processor for use with BinkleyTerm, however, other nodelist
  1199.                processors may be able to produce a QuickBBS nodelist of the
  1200.                required format.  Refer to the User's Guide section "Nodelist"
  1201.                for more information.
  1202.           
  1203.           Reader <command_line>
  1204.           
  1205.                Using the Alt-E command in Unattended Mode causes BinkleyTerm
  1206.                to send <command_line> to COMMAND.COM for execution as a child
  1207.                process.  This is typically used to invoke your local console
  1208.                message base reader/editor.  
  1209.           
  1210.           ReqOnUs
  1211.           
  1212.                When this statement is used, incoming file requests will be
  1213.                filled, even if your system initiated the call.  Otherwise,
  1214.                incoming requests "on your dime" will be refused. 
  1215.           
  1216.           ReqTemplate <filespec>
  1217.           
  1218.                This designates the name of the response file template used
  1219.                for request response file construction.  The <filespec> is a
  1220.                complete drive, path and filename designation.  
  1221.           
  1222.                For more information, refer to the User's Guide sections
  1223.                "Request Response Files" and "Security - Response File
  1224.                Templates."
  1225.           
  1226.           Rev3
  1227.           
  1228.                Normally, BinkleyTerm automatically determines the revision
  1229.                level of the FOSSIL driver you use.  Using 'Rev3' forces
  1230.                BinkleyTerm to assume that a revision 3 FOSSIL is installed. 
  1231.                Normally, this parameter is only used on systems which are
  1232.                using developmental FOSSIL drivers that may not yet fully
  1233.                support a higher revision.
  1234.           
  1235.           SameRing
  1236.           
  1237.                By default, and unless the 'NoCollide' option is used,
  1238.                BinkleyTerm will attempt to abort its dialing process if an
  1239.                incoming call is detected.  This feature is called "call
  1240.                collision detection."  'SameRing' is used when your modem
  1241.                reports "RING" on BOTH incoming and outgoing calls (most
  1242.                modems reports "RING" on incoming and "RINGING" on outgoing),
  1243.                and partially disables this feature.
  1244.           
  1245.           ScreenBlank
  1246.           
  1247.                If 'ScreenBlank' is used, and 10 minutes pass without any
  1248.                activity (incoming call, outgoing call), then the screen will
  1249.                be blanked.  The screen will remain blanked until the user
  1250.                presses the space bar.  Once the space bar is pressed, the
  1251.                next time BinkleyTerm writes to the screen, the screen will
  1252.  
  1253.               BinkleyTerm Version 2.30 - Reference Guide - Page 23
  1254.  
  1255.                be reactivated.
  1256.           
  1257.                'ScreenBlank' works only if a Video FOSSIL (VFOSSIL) is
  1258.                installed.  
  1259.           
  1260.           ScriptPath <path>
  1261.           
  1262.                If given, this statement tells BinkleyTerm where to look for
  1263.                outward dialing scripts (refer to the section "Scripts" for
  1264.                more information).  <path> is a standard DOS path line, with
  1265.                optional drive designation.  
  1266.           
  1267.           Shell <number> <command_line>
  1268.           
  1269.                This allows you configure up to 9 keystroke accessible DOS
  1270.                shells to run programs while BinkleyTerm stays memory
  1271.                resident.  Shells work only in Unattended Mode.  While in
  1272.                Terminal Mode, the same keystrokes work as macros keys (see
  1273.                the 'Macro' statement description for information).
  1274.           
  1275.                The <number> parameter is a digit between 1 and 9, which
  1276.                corresponds to the F1 through F9 keys.  While in Unattended
  1277.                Mode, you invoke a shell by pressing Alt-Fx, x indicating the
  1278.                shell number you wish to invoke.
  1279.           
  1280.                The <command_line> is sent to COMMAND.COM verbatim for
  1281.                execution.  If the program you're invoking uses command line
  1282.                parameters, include them in <command_line> as you would at the
  1283.                DOS prompt.
  1284.                         
  1285.           SlowModem
  1286.           
  1287.                Using 'SlowModem' causes BinkleyTerm to insert a 1/10th second
  1288.                delay between each character sent to the modem while in
  1289.                command mode.  This is for use with modems that may have a
  1290.                hard time keeping up with BinkleyTerm's modem commands
  1291.                otherwise.
  1292.           
  1293.           SmallWindow
  1294.           
  1295.                During mail transfers that use the SEAlink protocol,
  1296.                BinkleyTerm uses a default run ahead, in blocks, of the baud
  1297.                rate divided by 400.  Using this statement tells BinkleyTerm
  1298.                to run ahead no more than 6 blocks.  This option is used
  1299.                primarily with high speed modems.
  1300.           
  1301.           Statuslog <filespec>
  1302.           
  1303.                This tells BinkleyTerm where to log information about its
  1304.                operation and mail sessions.  This log is completely
  1305.                compatible with the log file used by Opus-CBCS.  The
  1306.                <filespec> is a complete drive, path and filename designation. 
  1307.                Various information is placed in the log.  See also the
  1308.                configuration file statement 'LogLevel.'               
  1309.  
  1310.               BinkleyTerm Version 2.30 - Reference Guide - Page 24
  1311.  
  1312.           
  1313.           Suffix <modem_string>
  1314.           
  1315.                BinkleyTerm will send the 'Prefix' string, followed by the
  1316.                phone number, followed by a carriage return to the modem for
  1317.                the purpose of dialing a number.  If for some reason you need
  1318.                to put characters immediately after the phone number BUT PRIOR
  1319.                TO THE RETURN CODE use the 'Suffix' field.
  1320.           
  1321.                NOTE:  Unlike some communications packages such as Telix,
  1322.                normally you DO NOT need a 'Suffix' with BinkleyTerm.  Use the
  1323.                'Suffix' field ONLY for adding characters to the end of the
  1324.                phone number, if needed. 
  1325.           
  1326.           SwapDir <path_name>
  1327.           
  1328.                By using this statement, BinkleyTerm will enable "memory
  1329.                swapping."  The <path_name> designated will be used by
  1330.                BinkleyTerm for storage of its swapfile when spawning
  1331.                subtasks, such as jumping to DOS, invoking a packer, and so
  1332.                on.  BinkleyTerm will swap itself out of memory except for
  1333.                about 5k to 8k of code.  If <path_name> points to a RAM disk
  1334.                (you will need about 150k of space available), BinkleyTerm
  1335.                exits and reloads very quickly.
  1336.           
  1337.                The <path_name> parameter may designated a directory path, or
  1338.                a combination of drive designator and directory path.
  1339.           
  1340.           Sysop <sysop_name>
  1341.           
  1342.                The WaZOO method of mail transfer (originally designed by Wynn
  1343.                Wagner for Opus-CBCS, and supported by BinkleyTerm) sends a
  1344.                variety of information during session negotiation.  Among the
  1345.                information is the Sysop name, normally your name.  This
  1346.                information is not passed during FTS-0001 mail session, and
  1347.                has no effect in Terminal Mode.
  1348.           
  1349.           System <system_name>
  1350.           
  1351.                The WaZOO method of mail transfer sends a variety of
  1352.                information during session negotiation.  Among the information
  1353.                is the system name, normally whatever name you have given to
  1354.                your BBS or Point system.  This information is not passed
  1355.                during FTS-0001 mail sessions, and has no effect in Terminal
  1356.                Mode. 
  1357.           
  1358.           TaskView
  1359.           
  1360.                This statement tells BinkleyTerm that the TaskView multi-
  1361.                tasker is installed, and to give up processor time-slice when
  1362.                the system is idle and while certain functions are being
  1363.                performed.  This increases system efficiency.
  1364.           
  1365.           
  1366.  
  1367.               BinkleyTerm Version 2.30 - Reference Guide - Page 25
  1368.  
  1369.           TBBSList
  1370.           
  1371.                This tells BinkleyTerm to expect and use a TBBS style
  1372.                nodelist.  To fully utilize this option, you must create the
  1373.                nodelist files with ParseLst 1.01 (or above), making sure that
  1374.                the proper adjunct nodelist files are available in addition
  1375.                to NODELIST.DOG.  Other nodelist processing packages may also
  1376.                produce TBBS style nodelist in the proper format for use with
  1377.                BinkleyTerm.  Refer to the User's Guide section "Nodelist" for
  1378.                more information.
  1379.           
  1380.           Timeout <seconds>
  1381.           
  1382.                This sets the number of seconds that BinkleyTerm will wait for
  1383.                a caller to press Escape or for a mail session to begin before
  1384.                assuming that the incoming call is human.  The default value
  1385.                is 20 seconds.  Note that <seconds> cannot be set lower than
  1386.                20.
  1387.           
  1388.           TopView
  1389.           
  1390.                This statement tells BinkleyTerm that the TopView multi-tasker
  1391.                is installed, and to give up processor time-slice when the
  1392.                system is idle and while certain functions are being
  1393.                performed.  This increases system efficiency.
  1394.           
  1395.           Unattended
  1396.           
  1397.                By default, BinkleyTerm is in Terminal Mode when invoked. 
  1398.                When this statement is used, BinkleyTerm will be in Unattended
  1399.                Mode when invoked from DOS.  This option should be used on
  1400.                systems where BinkleyTerm's primary purpose is as a FidoNet
  1401.                mail interface.
  1402.           
  1403.           Zone <zone_number>
  1404.           
  1405.                NOTE:  This statement is supported for backward compatibility
  1406.                only.  Please use the 'Address' statement discussed previously
  1407.                to designate a zone.
  1408.           
  1409.                This is part of the FidoNet node address for your BinkleyTerm
  1410.                system, and refers to the part of the globe you live in. 
  1411.                Current FidoNet zones are 1 for the Americas, 2 for Europe,
  1412.                3 for the South Pacific and 4 for South America.
  1413.           
  1414.           SCHEDULING EVENTS
  1415.                    
  1416.           As mentioned elsewhere in this manual, one of the driving forces
  1417.           behind BinkleyTerm mail handling is cost.  Rigid scheduling,
  1418.           although taking a back seat, still retains some importance.  In
  1419.           order for BinkleyTerm to know when it's time to send mail that
  1420.           requires a toll call, and in order for it to know when it can send
  1421.           to systems that do not accept Continuous Mail, event schedules are
  1422.           used.  Several other features are controlled by events as well.
  1423.  
  1424.               BinkleyTerm Version 2.30 - Reference Guide - Page 26
  1425.  
  1426.           
  1427.           Although events may be placed in the configuration file, they
  1428.           should be contained in a special file named BINKLEY.EVT.  In this
  1429.           way, small changes to the configuration file will not cause
  1430.           BinkleyTerm to re-run the current event; this will only happen if
  1431.           the BINKLEY.EVT file is edited.  
  1432.           
  1433.           By storing event schedules in a flat text file, events can be
  1434.           easily edited at any time with a standard ASCII text editor.  No
  1435.           special utilities are required.
  1436.           
  1437.           Note that each time an edit is made to BINKLEY.EVT (or to the
  1438.           configuration file if events are listed there), BinkleyTerm will
  1439.           re-build its binary schedule file, which will in turn cause
  1440.           BinkleyTerm to re-run the current event when the system is brought
  1441.           on-line.  This is normal operation, and is necessary to allow
  1442.           BinkleyTerm to properly register the schedule changes.
  1443.           
  1444.           Each event is on a separate line in the BINKLEY.EVT or
  1445.           configuration file.  Here is a sample of such a line:
  1446.           
  1447.                Event All 03:00 04:00 L=10 N B E1=10 E2=20 E3=30
  1448.           
  1449.           The syntax for the entries is:
  1450.           
  1451.                Event <day> <start> [<stop>] [<string>] <flags/options>
  1452.           
  1453.           <day>
  1454.           
  1455.                This tells BinkleyTerm which days this event line applies to. 
  1456.                Options are:
  1457.           
  1458.                     All . . . . Every day of the week
  1459.                     Week  . . . Weekdays, Monday through Friday only      
  1460.                     WkEnd . . . Weekends, Saturday and Sunday only         
  1461.                     Sun . . . . Sunday only
  1462.                     Mon . . . . Monday only
  1463.                     Tue . . . . Tuesday only
  1464.                     Wed . . . . Wednesday only
  1465.                     Thu . . . . Thursday only
  1466.                     Fri . . . . Friday only
  1467.                     Sat . . . . Saturday only
  1468.           
  1469.                The parameters can be linked with the pipe character (|) to
  1470.                indicate more than one option.  For example, "Mon|Wed|Fri"
  1471.                would that the event applies to Monday, Wednesday and Friday
  1472.                only.  No spaces may be used between the parameters.  The
  1473.                <day> parameter is REQUIRED.
  1474.           
  1475.           <start>
  1476.           
  1477.                This tells BinkleyTerm what time to start the event, in 24
  1478.                hour "military" time, in the format hh:mm, where hh is the
  1479.                hour and mm is the minute.  Note that <start> must NOT be
  1480.  
  1481.               BinkleyTerm Version 2.30 - Reference Guide - Page 27
  1482.  
  1483.                greater than <stop>, i.e., events may NOT stretch through the
  1484.                midnight hour.  The <start> parameter is REQUIRED.
  1485.           
  1486.                The <start> parameter may optionally take date information as
  1487.                well.  Allowable additional information is the month in
  1488.                numeric form (1 for January, 2 for February and so on, ending
  1489.                with 12 for December) and a day of the month.  This additional
  1490.                information is used IN ADDITION to the <day> parameter
  1491.                previously described.  A field that includes date information
  1492.                would be in the format:
  1493.           
  1494.                      hh:mm,month,day
  1495.           
  1496.                Where hh is the hour, mm is the minute, month is the numeric
  1497.                month, and day is the day of the month.  You may also leave
  1498.                out the day parameter, like this:
  1499.           
  1500.                     hh:mm,month
  1501.           
  1502.                If you wish to leave out a month parameter, simply place a
  1503.                zero into that field, indicating that the event is to take
  1504.                place on all months, like this:
  1505.           
  1506.                     hh:mm,0,day
  1507.           
  1508.                Using the date options with the <start> parameter offers
  1509.                significant scheduling power.  For example, if you wanted
  1510.                something to occur on the second Friday of each month, you can
  1511.                do so without a lot of manipulation by creating seven events
  1512.                with the same errorlevel, each corresponding the possible date
  1513.                values for the second Friday of each month, like this:
  1514.           
  1515.                     Fri 23:00,0,8  23:00 F E1=131
  1516.                     Fri 23:00,0,9  23:00 F E1=131
  1517.                     Fri 23:00,0,10 23:00 F E1=131
  1518.                     Fri 23:00,0,11 23:00 F E1=131
  1519.                     Fri 23:00,0,12 23:00 F E1=131
  1520.                     Fri 23:00,0,13 23:00 F E1=131
  1521.                     Fri 23:00,0,14 23:00 F E1=131
  1522.           
  1523.                In any given month, the event required on the second Friday
  1524.                of the month would cause an errorlevel 131 exit (which has
  1525.                been previously associated in your batch file with the
  1526.                function you wish to occur).
  1527.           
  1528.                In you wanted something to happen every leap year, you could
  1529.                create an event like this:
  1530.           
  1531.                     All 23:15,2,29 23:15 F E1=132
  1532.           
  1533.                Which would cause an errorlevel 132 exit on February 29.
  1534.           
  1535.                Note that if you want a specific exit on a specific date
  1536.                regardless of the day-of-the-week, you should use "All" for
  1537.  
  1538.               BinkleyTerm Version 2.30 - Reference Guide - Page 28
  1539.  
  1540.                the <day> parameter for that event. 
  1541.           
  1542.           [<stop>]
  1543.           
  1544.                This tells BinkleyTerm what time to stop the event.  This
  1545.                parameter is OPTIONAL, and defaults to 60 minutes after the
  1546.                start time should the parameter be omitted.  This is given in
  1547.                the same format the <start> parameter, as military time, hh:mm
  1548.                where hh is the hour and mm is the minute.
  1549.           
  1550.           [<string>]
  1551.           
  1552.                This parameter is OPTIONAL.  If used, <string> designates a
  1553.                string of characters to be added to the command line of the
  1554.                configuration file parameters 'Packer,' 'AfterMail' and
  1555.                'CleanUp.'  The string should be enclosed in quotation marks. 
  1556.                For example:
  1557.           
  1558.                     Event All 00:00 01:00 "-sA -c"
  1559.           
  1560.                The <string> is appended to the command lines given for these
  1561.                options in the configuration file, and should be ignored by
  1562.                those that do not need it.  It is suggested that batch files
  1563.                be used with the above mentioned configuration file options,
  1564.                and that the batch file(s) filter out unneeded information
  1565.                given in <string> before calling a program that might "cough"
  1566.                because the command line is wrong.
  1567.           
  1568.                Up to 32 extra characters can be added with the <string>
  1569.                parameter.
  1570.           
  1571.           <flags/options>
  1572.           
  1573.                This set of parameters tells BinkleyTerm about the event.  The
  1574.                various flags and options should be separated by a space.
  1575.                        
  1576.                C    The 'C' flag tells BinkleyTerm that during this event,
  1577.                     only mail marked as Continuous Mail will cause a call to
  1578.                     be made.  
  1579.           
  1580.                L=   The 'L=' flag is the 'less than or equal to cost' flag. 
  1581.                     For example, 'L=10' would mean that during this event,
  1582.                     only mail with a cost EQUAL TO OR LESS THAN 10 cents will
  1583.                     be sent (as designated by the nodelist cost field for a
  1584.                     particular entry.  Using 'L' alone, without a cost, means
  1585.                     that a value of '0' is used, and only mail with no cost
  1586.                     may be sent.  This is also called the 'local only' flag
  1587.                     when used with no cost parameter, since local calls in
  1588.                     most areas are free. 
  1589.           
  1590.                L<   The 'L<' flag works just like the 'L=' flag, except that
  1591.                     it means 'less than cost.'  For example, 'L<10' would
  1592.                     indicate that during the designated event, only mail with
  1593.                     a cost field of LESS THAN 10 cents will be sent.  
  1594.  
  1595.               BinkleyTerm Version 2.30 - Reference Guide - Page 29
  1596.  
  1597.           
  1598.                L>   The 'L>' flag works just like the 'L=' flag, except that
  1599.                     it means 'greater than cost.'  For example, 'L>10' would
  1600.                     indicate that during the designated event, only mail with
  1601.                     a cost field of GREATER THAN 10 cents will be sent.
  1602.           
  1603.                M    NOTE!  This flag should ONLY be used when the
  1604.                     'NewNodelist,' 'QuickNodelist' or 'TBBSList'
  1605.                     configuration file options are used!  The 'M' flag
  1606.                     indicates that the event is a 'mail' event, and that it
  1607.                     is okay to send mail to anyone in the nodelist,
  1608.                     regardless of their #CM designation.  This flag is
  1609.                     normally used during local mail schedules, and during
  1610.                     National Mail Hour. 
  1611.           
  1612.                N    This flag tells BinkleyTerm not to accept inbound file
  1613.                     requests during this event. 
  1614.           
  1615.                R    This flag tells BinkleyTerm that the event is 'Receive
  1616.                     Only.'  BinkleyTerm will not dial out to send mail,
  1617.                     however, it will send mail if polled for it.          
  1618.           
  1619.                B    This flag tells BinkleyTerm that BBS operation is allowed
  1620.                     during this event.  If this flag is NOT present, callers
  1621.                     will be greeted with the message "Processing
  1622.                     mail...please hang up."  Use this option at all times (if
  1623.                     you run a BBS) except during mail schedules, such as
  1624.                     National Mail Hour. 
  1625.           
  1626.                F    This flag tells BinkleyTerm that the event should be 
  1627.                     'forced' and will occur at the first possible moment. 
  1628.                     USUALLY YOU DO NOT NEED TO USE THIS FLAG.  BinkleyTerm
  1629.                     will execute the current event anyway if for some reason
  1630.                     the start time is bypassed (but before the stop time
  1631.                     passes).  If you do use this option, use it only on zero-
  1632.                     length events; those events for which the <start_time>
  1633.                     and <stop_time> are the same. 
  1634.           
  1635.                D    This flag tells BinkleyTerm that the event is dynamic. 
  1636.                     Dynamic events continue until there is no longer any mail
  1637.                     of the specified type to be sent.  For example, if the
  1638.                     dynamic event specifies that local Continuous Mail is to
  1639.                     be sent, the event will continue until there is no more
  1640.                     local Continuous Mail to be sent, or until the event
  1641.                     ends, whichever happens first.  When the dynamic  event
  1642.                     ends, the non-dynamic event scheduled for the same time
  1643.                     slot will take over.  If no such event exits, the system
  1644.                     will accept mail, but will dial out to no one.  Note that
  1645.                     dynamic events must be started before or at the same time
  1646.                     as non-dynamic events, if the dynamic event is to overlap
  1647.                     a non-dynamic one. 
  1648.           
  1649.                E1=  The 'E1=' option tells BinkleyTerm what errorlevel to
  1650.                     exit with at the beginning of the event.  'E1=10' would
  1651.  
  1652.               BinkleyTerm Version 2.30 - Reference Guide - Page 30
  1653.  
  1654.                     tell BinkleyTerm to exit to its start-up batch file with
  1655.                     errorlevel 10 when the event begins.  This is a good
  1656.                     method of executing functions once daily, for example,
  1657.                     message base maintenance software, and so on.  Once the
  1658.                     E1= exit has been made, it will not occur again until the
  1659.                     next time the event is scheduled. 
  1660.           
  1661.                E2=  The 'E2=' option tells BinkleyTerm what errorlevel to
  1662.                     exit with after mail is received.  The E2= exit is only
  1663.                     executed if the incoming mail does not meet the criteria
  1664.                     for an E3= exit, or if an E3= exit does not exist.  Using
  1665.                     your batch file, the errorlevel set for the E2= option
  1666.                     should invoke mail unpacking software to merge the
  1667.                     incoming mail with your message base. 
  1668.           
  1669.                E3=  The 'E3=' option tells BinkleyTerm what errorlevel to
  1670.                     exit with after compressed mail is received.  If mail is
  1671.                     received during the event, and compressed mail is not a
  1672.                     part of the mail received, then an E2= exit is performed. 
  1673.                     If compressed mail was received (even in conjunction with
  1674.                     other mail or files) then the E3= exit is performed. 
  1675.                     Using your batch file, the errorlevel you set for this
  1676.                     option should invoke mail unpacking software that can
  1677.                     handle compressed mail and merge it with your message
  1678.                     base.
  1679.           
  1680.                A=   This allows you to control the amount of time that
  1681.                     BinkleyTerm will sit idle between attempting an outgoing
  1682.                     call.  The format is "A=x" where x is the number of
  1683.                     seconds desired, which can be a number between 0 and 1800
  1684.                     (1800 seconds = 30 minutes). 
  1685.           
  1686.                     The average wait between calls is based on +/- 50% of the
  1687.                     number specified, i.e., A=60 would yield a wait time in
  1688.                     the range of 30 to 90 seconds, 60 being the average.  
  1689.           
  1690.                     Should the A= parameter not be used, the default value
  1691.                     is 120, for an average wait time of between 60 and 180
  1692.                     seconds. 
  1693.           
  1694.                K    This option tells BinkleyTerm not to send to any nodes
  1695.                     marked in the nodelist as #CM (accepts Continuous Mail). 
  1696.                     Note that this option is only valid when an Opus Version
  1697.                     6, QuickBBS or TBBS nodelist is in use.  
  1698.           
  1699.                T=   This option allows you to control the maximum number of
  1700.                     call attempts and failed connects that will be acceptable
  1701.                     to BinkleyTerm.  The T= option accepts two parameters,
  1702.                     and is used in the format "T=x,y" where x is the maximum
  1703.                     number of failed connects (carrier established, session
  1704.                     fails - a chargeable call in toll situations), and y is
  1705.                     the maximum number of call attempts (no answer, no
  1706.                     session - generally NOT a chargeable call in toll
  1707.                     situations). 
  1708.  
  1709.               BinkleyTerm Version 2.30 - Reference Guide - Page 31
  1710.  
  1711.           
  1712.                     Generally, the x parameter should be very low, so as not
  1713.                     to rack up charges on your phone bill should the call be
  1714.                     long distance or another toll call.  The y parameter is
  1715.                     generally set rather high, since these calls are usually
  1716.                     not charged for. 
  1717.           
  1718.                     The default x parameter is 3, the default y parameter has
  1719.                     not been explicitly specified, but is quite high. 
  1720.           
  1721.                X    By default, BinkleyTerm will treat outgoing file requests
  1722.                     (.REQ files) in the same manner as Normal packets and
  1723.                     attaches.  This would include forcing a dial attempt
  1724.                     during events that would allow Normal mail to be sent. 
  1725.                     Sometimes this is undesirable operation, such as during
  1726.                     National Mail Hour when destination systems typically do
  1727.                     not accept file requests.  Using the 'X' flag for an
  1728.                     event tells BinkleyTerm not to force a call for a file
  1729.                     request.  Please note that other types of mail, such as
  1730.                     packets and attaches, may cause BinkleyTerm to dial a
  1731.                     system for which an outbound file request is pending.
  1732.           
  1733.           Many of the above options can be used with one another, and in fact
  1734.           usually are.  Constructing a working event schedule can be a time
  1735.           consuming process requiring a certain amount of trial and error. 
  1736.           Since the event schedule plays a very important roll on when mail
  1737.           will be sent, it should be manipulated VERY carefully to avoid
  1738.           having BinkleyTerm make toll calls during high rate periods.  
  1739.           
  1740.           A sample event schedule is shown in BINKLEY.EVT, contained in the
  1741.           distribution package.  Print out the file if desired, but in any
  1742.           case, study it carefully and make sure you understand the various
  1743.           options before going ahead.
  1744.           
  1745.           
  1746.           
  1747.           
  1748.           
  1749.           
  1750.           
  1751.           
  1752.           
  1753.           
  1754.           
  1755.           
  1756.           
  1757.           
  1758.           
  1759.           
  1760.           
  1761.           
  1762.           
  1763.           
  1764.           
  1765.  
  1766.               BinkleyTerm Version 2.30 - Reference Guide - Page 32
  1767.  
  1768.           +-------------+
  1769.           | +---------+ |
  1770.           | | Section | |   BinkleyTerm Reference Guide
  1771.           | |    3    | |   GENERAL REFERENCE INFORMATION
  1772.           | +---------+ |
  1773.           +-------------+
  1774.           
  1775.           COMMAND LINE PARAMETERS
  1776.           
  1777.           BinkleyTerm offers a selection of command line parameters which
  1778.           each have a unique function.  The words that are descibed below are
  1779.           simply placed on the DOS command line - no hyphens or slashes are
  1780.           necessary.  For example:
  1781.           
  1782.                BT NoForce Unattended Share Config C:\BT\SYS1.CFG
  1783.           
  1784.           Here is a list of the command line parameter options:
  1785.           
  1786.                NoForce
  1787.           
  1788.                     Don't force events that have already passed.
  1789.           
  1790.                Mail
  1791.           
  1792.                     For Point system use, this causes BinkleyTerm to attempt
  1793.                     connection to the boss upon start-up.
  1794.           
  1795.                Share
  1796.           
  1797.                     Leaves the FOSSIL driver "hot" (does not de-initialize
  1798.                     the driver upon exit) for use with other FOSSIL-based
  1799.                     systems. 
  1800.           
  1801.                Dynam
  1802.           
  1803.                     Restart the current dynamic event, if any, even if it may
  1804.                     have already executed.
  1805.           
  1806.                Unattended
  1807.           
  1808.                     Run in Unattended Mode, regardless of whether the
  1809.                     'Unattended' configuration file statement is used.
  1810.           
  1811.                Config
  1812.           
  1813.                     Allows specification of a configuration file other than
  1814.                     the default (BINKLEY.CFG).  This parameter must be
  1815.                     followed by a single space, and then the name of the
  1816.                     configuration file, including drive and path if
  1817.                     applicable, for example:  "BT Config C:\BT\MYCONFIG.CFG"
  1818.           
  1819.                Poll
  1820.           
  1821.                     Instructs BinkleyTerm to immediately poll a given node. 
  1822.  
  1823.               BinkleyTerm Version 2.30 - Reference Guide - Page 33
  1824.  
  1825.                     Upon completion of the poll, BinkleyTerm will exit.  For
  1826.                     example:  "BT Poll 1:132/101" 
  1827.           
  1828.           DIAL TRANSLATION
  1829.           
  1830.                When BinkleyTerm is in modem command mode, several dial
  1831.                translations take place automatically.
  1832.           
  1833.                ASCII  Char.   Name                Action
  1834.                ------ ------- ------------------- ------------------------ 
  1835.                045    -       Hyphen              Stripped
  1836.                046    .       Period              Translated to a Comma
  1837.                094    ^       Carat               Raise DTR Line
  1838.                096    `       Accent Mark         1/20th Second Delay  
  1839.                118    v       Lower Case V        Lower DTR Line
  1840.                124    |       Pipe, Split Bar     Carriage Return Sent
  1841.                126    ~       Tilde               1 Second Delay
  1842.           
  1843.           RESPONSE FILE TEMPLATE
  1844.           
  1845.           Response files are explained in the User's Guide section "Request
  1846.           Response Files."
  1847.           
  1848.           Response files are generated according to a template file which
  1849.           designates exactly what is to be placed in the finished response
  1850.           file.  Most options perform simple macro substitution; others allow
  1851.           conditional inclusion of text, or instruct BinkleyTerm what to do
  1852.           with the response file.
  1853.           
  1854.           Response files will be generated according to the template under
  1855.           any one of the following cases, called reason codes:
  1856.           
  1857.                1 - File Not Found
  1858.                2 - No Update Necessary
  1859.                3 - Password Missing or Wrong
  1860.                4 - Request Limit Exceeded
  1861.                5 - Start of No-Requests-Honored Event
  1862.                9 - Successful Request
  1863.           
  1864.           By default, when a template is designated in the configuration
  1865.           file, BinkleyTerm will always generate a response file for all of
  1866.           the above reasons.  It is possible, however, to control or limit
  1867.           what the response file says based on a particular reason code, or
  1868.           to not have a response file generated at all for a particular
  1869.           reason code.
  1870.           
  1871.           BinkleyTerm uses the template file serially, and copies everything
  1872.           found in the template directly to the response file, performing
  1873.           substitution or conditional copies as directed by template file
  1874.           verbs.  When the end of the template is reached the response file
  1875.           is closed and sent to the calling system (unless an %exit verb is
  1876.           used before the end of the file).
  1877.           
  1878.           All the allowed verbs in the template begin with a percent sign
  1879.  
  1880.               BinkleyTerm Version 2.30 - Reference Guide - Page 34
  1881.  
  1882.           (%), a character which should not be used for any other purpose
  1883.           within the file.
  1884.           
  1885.           Allowed verbs are as follows:
  1886.           
  1887.           %;
  1888.           
  1889.                When placed in column 1 (far left), designates a comment line. 
  1890.                When in any other column, designates that remainder of line
  1891.                should be ignored.
  1892.           
  1893.           %abort
  1894.           
  1895.                Don't send response file.
  1896.           
  1897.           %abort <number>
  1898.           
  1899.                When <number> matches the reason code, don't send response
  1900.                file.
  1901.           
  1902.           %exit
  1903.           
  1904.                Close the response file and send as-is.
  1905.           
  1906.           %exit <number>
  1907.           
  1908.                When <number> matches the reason code, close the response file
  1909.                and send as-is.
  1910.           
  1911.           %text <number> <text>
  1912.           
  1913.                When %status is given later in the template, <text> is copied
  1914.                into the response file if <number> matches the reason code. 
  1915.                The <text> should be no longer than 255 characters in length,
  1916.                and may contain other template verbs such as %system, %date,
  1917.                and so on.
  1918.           
  1919.           %line <number> <text>
  1920.           
  1921.                If <number> matches the reason code, <text> is copied into the
  1922.                response directly.  The <text> should not exceed 255
  1923.                characters in length, and may contain other template file
  1924.                verbs such as %system, %date, and so on.
  1925.           
  1926.           %date
  1927.           
  1928.                Copies the current date into the response file.
  1929.           
  1930.           %time
  1931.           
  1932.                Copies the current time into the response file.
  1933.           
  1934.           
  1935.           
  1936.  
  1937.               BinkleyTerm Version 2.30 - Reference Guide - Page 35
  1938.  
  1939.           %bink
  1940.           
  1941.                Copies the program name and version into the response file. 
  1942.                For example:
  1943.           
  1944.                     BinkleyTerm 2.30
  1945.           
  1946.           %mynode
  1947.           
  1948.                Copies your node address into the response file.
  1949.           
  1950.           %system
  1951.           
  1952.                Copies your system name, as given in the BinkleyTerm
  1953.                configuration file, to the response file.
  1954.           
  1955.           %sysop
  1956.           
  1957.                Copies your Sysop name, as given in the BinkleyTerm
  1958.                configuration file, to the response file.
  1959.           
  1960.           %yrnode
  1961.           
  1962.                Copies the node address of the calling system into the
  1963.                response file.
  1964.           
  1965.           %request
  1966.           
  1967.                Copies into the response file the actual line from the
  1968.                incoming request that prompted the creation of the response
  1969.                file.  Normally this is the name of the file that caused the
  1970.                response file to be generated.
  1971.           
  1972.           %status
  1973.           
  1974.                Copies text previously defined for the current reason code
  1975.                with the %text verb into the response file.
  1976.           
  1977.           A complete sample template file is included with the BinkleyTerm
  1978.           distribution package.  Use the file as a base to design your own
  1979.           unique file.
  1980.           
  1981.           SCRIPTS
  1982.           
  1983.           A script is a series of instructions used when dialing a particular
  1984.           system.  They allow the system to "look" for particular information
  1985.           coming across the line, and act according when the desired
  1986.           information is received within a set time limit.  Scripts are
  1987.           essentially a mini programming language, and as such, take study
  1988.           and practice to use effectively.  
  1989.           
  1990.           Scripts are stored in a flat ASCII text file, and edited using any
  1991.           standard text editor (such as DOS' own EDLIN).  Once written,
  1992.           scripts are associated with a particular nodelist entry for use
  1993.  
  1994.               BinkleyTerm Version 2.30 - Reference Guide - Page 36
  1995.  
  1996.           each time the given node is dialed.  
  1997.           
  1998.           Possible applications for scripts include accessing packet switch
  1999.           networks, such as GTE/Telenet's PC Pursuit service, that require
  2000.           multiple sets of operations to reach the desired destination.
  2001.           
  2002.           The use of a script is triggered by the appearance of a file name,
  2003.           inside double quotes, in the phone number field of a nodelist
  2004.           entry.  For example, instead of seeing 1-303-555-6789 in the
  2005.           nodelist data file, you might see "MYSCRIPT.SCR"303-555-6789. 
  2006.           Notice that the name of the script file is IMMEDIATELY (without
  2007.           spaces) followed by the area code and phone number.  The field must
  2008.           appear in the format shown, including hyphens.  The area code
  2009.           portion of the number can be up to 10 characters long (for use with
  2010.           certain long distance carriers).
  2011.           
  2012.           Script references can also be placed in your configuration file by
  2013.           way of the 'Dial' statement.  See "Configuration File" for details.
  2014.           
  2015.           Refer to the documentation for your nodelist processor for
  2016.           information on inserting information into the phone number field
  2017.           of a nodelist entry.
  2018.           
  2019.           The following restrictions apply when using scripts:
  2020.           
  2021.                - Any line beginning with anything other than a letter or a
  2022.                colon (:) is ignored as a comment.
  2023.           
  2024.                - All lines must begin flush left...at the left margin.
  2025.           
  2026.                - All keywords that take arguments must be followed by exactly
  2027.                ONE space between the keyword and the argument.
  2028.           
  2029.                - There should be NO extra characters at the ends of lines. 
  2030.                This includes space characters.  All characters on a line are
  2031.                significant, including any extra spaces that you may have
  2032.                inadvertently included.
  2033.           
  2034.                - Script commands and script labels are NOT case sensitive.
  2035.           
  2036.           Please note that spaces can cause hard-to-track-down problems. 
  2037.           Spaces are significant characters, meaning they are NOT ignored in
  2038.           patterns, etc.  Do not use a space unless you intend to, and do not
  2039.           leave any at the ends of lines unless you want them there. 
  2040.           
  2041.           Here are the script statements available to you:
  2042.           
  2043.           :<label>
  2044.           
  2045.                The colon (:) starts a label.  Labels can be up to 20
  2046.                characters long.  Control can be passed to the location in the
  2047.                script identified by a label using the 'If' and 'Goto' script
  2048.                statements.  Up to 50 labels per script are allowed.
  2049.           
  2050.  
  2051.               BinkleyTerm Version 2.30 - Reference Guide - Page 37
  2052.  
  2053.           Abort [<start_time> <stop_time>]
  2054.           
  2055.                Allows conditional aborting of script execution based on time
  2056.                of day.  If used without arguments, it causes unconditional
  2057.                aborting of execution.  If arguments are used, script
  2058.                execution will abort if the current time is between the hours
  2059.                given with <start_time> and <stop_time>.  For example,
  2060.                "Abort 8:00 22:00" would make the script abort between the
  2061.                hours of 8:00am and 10:00pm.  The hours CAN wrap through
  2062.                midnight, "Abort 22:00 3:00" would be an example of this.
  2063.           
  2064.           Areacode
  2065.           
  2066.                Transmits the areacode portion of the phone number to the
  2067.                modem, as shown in the given nodelist entry. 
  2068.           
  2069.           Baud [<baud_rate>]
  2070.           
  2071.                This statement sets the baud rate for the call to the value
  2072.                given.  If no <baud_rate> is given, the baud rate as listed
  2073.                in the nodelist for this node is used.
  2074.           
  2075.           Break [<duration>]
  2076.           
  2077.                This causes a "break" signal to be sent, as needed with some
  2078.                types of host systems.  <duration> designates the number of
  2079.                hundredths of a second for the break signal to last.  If the
  2080.                <duration> parameter is not given, the default duration value
  2081.                of 100 (1 second) will be used.
  2082.           
  2083.           Carrier
  2084.           
  2085.                Continue the script if there is carrier, abort if there is
  2086.                not.
  2087.           
  2088.           Comm <settings>
  2089.           
  2090.                Allows setting of the communications parameters.  <settings>
  2091.                is a three-character string, consisting of the number of data
  2092.                bits, parity and number of stop bits.  For example, a
  2093.                <settings> string of "8N1" would cause the parameters to be
  2094.                set to 8 data bits, No parity, and 1 stop bit.  "7E1" would
  2095.                cause 7 data bits, Even parity, and 1 stop bit.  "7O2" would
  2096.                cause 7 data bits, Odd parity, and 2 stop bits.
  2097.           
  2098.                Possible values are 7 or 8 for data bits, E (even), O (odd)
  2099.                or N (none) for the parity, and 1 or 2 for stop bits.
  2100.           
  2101.                NOTE!  The string is NOT checked for accuracy.  The user is
  2102.                responsible for making sure that it is correct!
  2103.           
  2104.           Dial
  2105.           
  2106.                Dial the entire telephone number, and wait for a valid
  2107.  
  2108.               BinkleyTerm Version 2.30 - Reference Guide - Page 38
  2109.  
  2110.                response.  Continue if there is carrier, abort if there is
  2111.                not.
  2112.           
  2113.           DOS <command_line>
  2114.           
  2115.                Causes the <command_line> to be sent to DOS for execution. 
  2116.                Upon completion, script execution continues.  Sufficient
  2117.                memory must exist for any application executed by this
  2118.                command.
  2119.           
  2120.           Goto <label>
  2121.           
  2122.                This statement causes the script processor to jump to the
  2123.                location in the script pointed to by <label>.  A colon (:)
  2124.                must have previously been used in the script to identify the
  2125.                <label>.  If the label does not exist, the script aborts.
  2126.           
  2127.           If <pattern_number> <label>
  2128.           
  2129.                If a match for <pattern_number> was found at the last 'Wait'
  2130.                statement, transfer control to the point in the script
  2131.                identified by <label>.  If a match was not found, control
  2132.                continues to the next statement in the script.  'If' can be
  2133.                used at any time prior to the next 'Wait' statement.
  2134.           
  2135.           NoWaZOO
  2136.           
  2137.                Forces BinkleyTerm to be strictly an FSC-0001 mailer by
  2138.                disabling WaZOO functionality for the current outgoing session
  2139.                only.  This is primarily of interest to coordinators who wish
  2140.                to verify that their nodes are meeting FidoNet compatibility
  2141.                requirements.
  2142.           
  2143.                There is no benefit to the average user from using this
  2144.                statement.  In fact, performance with other WaZOO-capable
  2145.                mailers (BinkleyTerm, Opus, D'Bridge, FrontDoor, etc.) will
  2146.                be adversely affected.
  2147.           
  2148.           Pattern <pattern_number> <string>
  2149.           
  2150.                This statement establishes a pattern for the script handler
  2151.                to look for during the next 'Wait' statement.  <string> IS
  2152.                case sensitive.  The script handler will look an EXACT match
  2153.                for the series of characters in <string> during the next
  2154.                'Wait' statement.  Up to 8 patterns can be used, and they can
  2155.                be reused or reset at will.  Up to 20 characters can be used
  2156.                in a pattern. 
  2157.           
  2158.                The purpose is to wait for a given string from the host, or
  2159.                a particular modem response string, and to act accordingly.
  2160.           
  2161.           Phone
  2162.           
  2163.                Transmits the local portion of the phone number to the modem,
  2164.  
  2165.               BinkleyTerm Version 2.30 - Reference Guide - Page 39
  2166.  
  2167.                as shown in the given nodelist entry.  Hyphens are stripped
  2168.                automatically.
  2169.           
  2170.           
  2171.           Rawxmit <string>
  2172.           
  2173.                This works in the same manner as the 'Xmit' statement, except
  2174.                that dial translation is NOT performed. 
  2175.           
  2176.           Session
  2177.           
  2178.                This should be used at the end of a script which has been
  2179.                successful.  It tells BinkleyTerm to begin a NetMail session
  2180.                with the remote system.
  2181.           
  2182.           Speed
  2183.           
  2184.                Causes BinkleyTerm to send the baud rate divided by 100 as a
  2185.                string.  The baud rate used it the rate specified for the node
  2186.                in the nodelist, or the rate specified by a prior call to the
  2187.                'Baud' statement.  For example, if the current connect rate
  2188.                was 2400 baud, the string "24" would be sent when this
  2189.                statement is encountered.
  2190.           
  2191.           Timer <seconds>
  2192.           
  2193.                Sets a master countdown timer to <seconds>.  If the timer
  2194.                expires, the script will abort.  This allows you to set
  2195.                timeouts on any portion of, or the entire script.  You may
  2196.                reset the timer by using another 'Timer' statement. 
  2197.           
  2198.           Wait [<seconds>] [<label>]
  2199.           
  2200.                Wait for a maximum of <seconds> for one of the previously set
  2201.                patterns to be matched.  If a pattern is matched, the script
  2202.                continues, otherwise it aborts.  If <label> is provided, the
  2203.                script will resume operation at the label specified upon
  2204.                timeout.  Note that the default value is 40 seconds.  Both
  2205.                <seconds> and <label> are optional.  A <label> may be
  2206.                specified without specifying <seconds>.  For example:
  2207.           
  2208.                     Wait 40 foo
  2209.           
  2210.                is the same as:
  2211.           
  2212.                     Wait foo
  2213.           
  2214.           Xmit <string>
  2215.           
  2216.                Transmits <string> to the modem.  Normal BinkleyTerm
  2217.                translations are valid (refer to the section "Dial
  2218.                Translation" for information).  
  2219.           
  2220.           In addition to the statements above, the following logical
  2221.  
  2222.               BinkleyTerm Version 2.30 - Reference Guide - Page 40
  2223.  
  2224.           variables are also available:
  2225.           
  2226.           BPSxxxx
  2227.           
  2228.                Allows branching or actions based on baud rate.  For example,
  2229.                the statement
  2230.           
  2231.                     IF BPS2400 DO2400
  2232.           
  2233.                would cause script execution to jump to the previously defined
  2234.                label "DO2400" is the current connection was at 2400 bps
  2235.                (baud).  Other examples might be "BPS9600" for 9600 bps
  2236.                connections, "BPS1200" for a 1200 bps connection, etc.
  2237.           
  2238.           TERMINAL MODE KEYSTROKES
  2239.           
  2240.           While in Terminal Mode, several keystrokes are available that allow
  2241.           uploading and downloading of files, changing of communications
  2242.           parameters, and so on.
  2243.           
  2244.           Alt-F1 through Alt-F9
  2245.           
  2246.                These keystrokes allow you to send user-defined macros. 
  2247.                Please refer to the section "Configuration File" for
  2248.                information on Terminal Mode macros.
  2249.           
  2250.           Alt-F10
  2251.           
  2252.                This provides a brief help screen, listing the key-presses
  2253.                available to you in Terminal Mode.
  2254.           
  2255.           Alt-B
  2256.           
  2257.                This allows you to step the baud rate up to the next higher
  2258.                value.  BinkleyTerm supports baud rates of 300, 1200, 2400,
  2259.                4800, 9600, 19,200 and 38,400.  38,400 baud wraps to 300 baud.
  2260.           
  2261.           Alt-C
  2262.           
  2263.                This allows you to set various communications parameters,
  2264.                including number of data bits, parity, and number of stop
  2265.                bits.  You are prompted for the information.  Note that when
  2266.                8 bits are set, BinkleyTerm defaults to no parity, and you are
  2267.                not prompted for the setting.
  2268.           
  2269.           Alt-D  
  2270.           
  2271.                Allows you to dial out.  When prompted, you may enter one of
  2272.                three items: a telephone number, a FidoNet node address in the
  2273.                form [<zone>:]<net>/<node>, or a FidoNet Sysop name.  
  2274.           
  2275.                Entering a FidoNet address requires the presence of a compiled
  2276.                nodelist, properly referenced in the BinkleyTerm configuration
  2277.                file.  Entering a Sysop name requires that your nodelist
  2278.  
  2279.               BinkleyTerm Version 2.30 - Reference Guide - Page 41
  2280.  
  2281.                processing software, e.g., ParseLst, has created a compatible
  2282.                list named FIDOUSER.LST.  Refer to your nodelist processing
  2283.                software documentation for more information about creating
  2284.                FIDOUSER.LST. 
  2285.           
  2286.           Alt-H
  2287.           
  2288.                Hang-up.  This command toggles the modem's DTR (data  terminal
  2289.                ready) line, thereby disconnecting any call in progress.  The
  2290.                modem init string is sent to the modem after DTR is toggled.
  2291.           
  2292.           Alt-J
  2293.           
  2294.                Jump to DOS.  Invokes COMMAND.COM to allow for "quick and
  2295.                dirty" DOS commands on the fly.  Enter "EXIT" at the DOS
  2296.                prompt to return to BinkleyTerm.  BinkleyTerm will
  2297.                automatically return to the directory it was run from when
  2298.                returning from DOS.
  2299.                    
  2300.           Alt-L
  2301.           
  2302.                Toggle session logging on and off.  The session logging
  2303.                function allows you to designate a file or printer, and have
  2304.                the entire terminal mode session echoed to the selected file
  2305.                or device.  
  2306.           
  2307.                When first invoked, this command will prompt you for a file
  2308.                name.  Type in the desired name of the log file, including
  2309.                drive and path designation if desired.  You may also enter a
  2310.                printer device name, e.g., PRN, LPT1, LPT2, etc. for printer
  2311.                echoing. 
  2312.           
  2313.                Invoke the command again to end logging to the file or device.
  2314.           
  2315.           Alt-M
  2316.           
  2317.                Poll a node in the nodelist, by node address.  This command
  2318.                requires that mail handling be implemented as described in the
  2319.                User's Guide section, "Unattended Mode Overview".
  2320.           
  2321.                You are prompted for a FidoNet node address.  Once entered,
  2322.                BinkleyTerm will dial the system (if its exists in the
  2323.                nodelist) and attempt to exchange mail with the system.  If
  2324.                there is outgoing mail to the system, or if mail is waiting
  2325.                for you on the remote system, it will be sent during the mail
  2326.                session.
  2327.           
  2328.           Alt-P
  2329.           
  2330.                This command allows you to change the communications port in
  2331.                use.  Invoking the command shifts the port number to the next
  2332.                higher port.  The number of ports supported is determined by
  2333.                your hardware, and by the 'Maxport' statement in the
  2334.                configuration file.  
  2335.  
  2336.               BinkleyTerm Version 2.30 - Reference Guide - Page 42
  2337.  
  2338.           
  2339.           Alt-R
  2340.                         
  2341.                This allows you to dial out with a "scan list."  Empty
  2342.                elements are designated by 'Null.'  Using the function keys 
  2343.                (or equivalently numbered numeric keys) you can select the
  2344.                scan list element you wish to enter.  Enter a telephone
  2345.                number, node address or Sysop name, just as you would with the
  2346.                Alt-D command.  Press 'Enter' to "store" your entry for that
  2347.                element.  When you have stored all the desired elements, press
  2348.                'Enter' to begin the dialing process. 
  2349.           
  2350.                Each number will be dialed in sequence, until a connection is
  2351.                made.  After the session is completed, a 'Null' will be stored
  2352.                for that element.  Invoke Alt-R again, and press 'Enter' to
  2353.                dial the remaining elements.  Press 'Escape' at any time to
  2354.                abort the dialing process.
  2355.           
  2356.                Note that unless saved, the dialing list is volatile.  Once
  2357.                you exit the Terminal Mode, your dialing list will be erased. 
  2358.           
  2359.                It is possible to save to and retrieve from the disk media up
  2360.                to 10 separate lists of entries.  To save a list, press Shift-
  2361.                Fn, where 'n' is the number of the list to save.  For example,
  2362.                Shift-F3 would save the current list of 10 entries to list
  2363.                number 3.  To retrieve a previously saved list, press Alt-Fn,
  2364.                where 'n' is the number of the list to retrieve.  For example,
  2365.                Alt-F5 would retrieve the 10 entries previous saved as list
  2366.                number 5.
  2367.                        
  2368.           Alt-S
  2369.           
  2370.                Invoking this command sends a "break" signal via the modem to
  2371.                the remote host.  This command requires that a FOSSIL of
  2372.                revision 5 or later be installed.  
  2373.           
  2374.           Alt-U
  2375.           
  2376.                This command is used in Point and BBS installations to shift
  2377.                to Unattended Mode.  BinkleyTerm is put into the mailer mode,
  2378.                ready to accept calls from remote systems.  In order to
  2379.                operate, the mailer functions must be implemented as described
  2380.                in the User's Guide section, "Unattended Mode Overview".
  2381.                    
  2382.           Alt-X
  2383.           
  2384.                Allows you to exit the program and return to DOS.  If
  2385.                BinkleyTerm was invoked with a batch file, this command will
  2386.                cause BinkleyTerm to exit to the batch file with and
  2387.                errorlevel of 1.  The batch file must trap this errorlevel,
  2388.                and exit accordingly.
  2389.           
  2390.                Note that this function DOES leave the DTR (data terminal
  2391.                ready) line on the modem 'high.'  
  2392.  
  2393.               BinkleyTerm Version 2.30 - Reference Guide - Page 43
  2394.  
  2395.           
  2396.           Alt-Y
  2397.           
  2398.                Used primarily for Point operations, this function initiates
  2399.                a mail session with the host.  This is designed ONLY to work
  2400.                with the system listed as your Boss node in the configuration
  2401.                file.  
  2402.           
  2403.                Issuing this keystroke invokes a temporary mailer mode, and
  2404.                BinkleyTerm attempts to dial the Boss system to exchange mail. 
  2405.                Mail handling must be set-up as described in the User's Guide
  2406.                section, "Unattended Mode Overview".
  2407.           
  2408.                If mail is waiting to be sent to the Boss, or if mail is
  2409.                waiting on the Boss system for pickup, it will be sent during
  2410.                the mail session.
  2411.           
  2412.           PgDn
  2413.           
  2414.                This allows you to download a file from the host with which
  2415.                you are connected.  You are prompted for the desired protocol
  2416.                to use, and for the required file information, if needed
  2417.                (protocol dependent).  If you have the 'Download' statement
  2418.                properly implemented in the configuration file, the downloaded
  2419.                files will be placed in the directory specified.  Otherwise,
  2420.                the file will be saved to the current directory. 
  2421.           
  2422.           PgUp
  2423.           
  2424.                This allows you to send a file to the remote host.  You are
  2425.                prompted for the desired protocol to use for the transfer, as
  2426.                well as the file information.  You may specify a complete
  2427.                drive, path and filename using standard DOS conventions, e.g.,
  2428.                C:\PATH\FILENAME.ARC.  
  2429.           
  2430.                When a batch protocol is used (SEAlink, Telink, or Zmodem),
  2431.                wildcards are allowed in the filename.  
  2432.           
  2433.           UNATTENDED MODE KEYSTROKES
  2434.           
  2435.                While in Unattended Mode, several keystrokes are available
  2436.                that perform various functions, such as manual polling, call
  2437.                forcing, DOS shells, and so on.
  2438.           
  2439.           F1 through F10
  2440.           
  2441.                These keys cause BinkleyTerm to exit with an errorlevel of 10
  2442.                times the function key number pressed.  In other words, F1
  2443.                causes an errorlevel 10 exit, F7 would cause an errorlevel 70
  2444.                exit.  Your batch file is used to capture and process these
  2445.                errorlevels.  
  2446.           
  2447.           
  2448.           
  2449.  
  2450.               BinkleyTerm Version 2.30 - Reference Guide - Page 44
  2451.  
  2452.           Alt-F1 through Alt-F9
  2453.           
  2454.                These keystrokes invoke user-defined DOS shells, to execute
  2455.                programs or utilities as desired.  Refer to the section
  2456.                "Configuration File" for additional information.
  2457.           
  2458.           Alt-F10
  2459.           
  2460.                This key causes BinkleyTerm to display a brief help screen,
  2461.                listing the various keystrokes available to you in the current
  2462.                operating mode.
  2463.           
  2464.           Alt-B
  2465.           
  2466.                Forces a screen blank to occur.  Any system activity or a
  2467.                press of the space bar will reactivate the screen display.
  2468.           
  2469.           Alt-C
  2470.           
  2471.                Causes information in the Unattended Mode "Today at a Glance"
  2472.                window to be "zeroed" out.  The information is NOT stored to
  2473.                the BINKLEY.DAY file prior to being zeroed.
  2474.           
  2475.           Alt-E
  2476.           
  2477.                This invokes your message editor/reader, as designated by the
  2478.                configuration file parameter 'Reader.'  Refer to the section
  2479.                "Configuration File" for more information.
  2480.           
  2481.           Alt-J
  2482.           
  2483.                This causes BinkleyTerm to exit to DOS and stay resident (DOS
  2484.                shell).  This is probably the most efficient method to perform
  2485.                a quick DOS command "on the fly."  Enter "EXIT" at the DOS
  2486.                prompt to return to BinkleyTerm.  BinkleyTerm will
  2487.                automatically return to the directory it was run from when
  2488.                returning from DOS.
  2489.           
  2490.           Alt-M
  2491.           
  2492.                This keystroke allows you to perform a manual mail polling
  2493.                operation.  You will be prompted for a FidoNet node address
  2494.                in the form <net>/<node>.  You may also enter a Sysop name if
  2495.                a FIDOUSER.LST is available to BinkleyTerm in the nodelist
  2496.                directory.  Refer to the User's Guide section "Nodelist" for
  2497.                more information on FIDOUSER.LST.  BinkleyTerm will then dial
  2498.                the system, without regard to event schedules, and attempt to
  2499.                transact mail with the remote system. 
  2500.           
  2501.           Alt-R
  2502.           
  2503.                This forces BinkleyTerm to restart the first event that should
  2504.                execute at the current time, not including forced events.  
  2505.           
  2506.  
  2507.               BinkleyTerm Version 2.30 - Reference Guide - Page 45
  2508.  
  2509.           Alt-T
  2510.           
  2511.                This is used to shift to Terminal Mode on the fly.  By using
  2512.                the Alt-U command of the Terminal Mode, you can flip back and
  2513.                forth between Terminal Mode and Unattended Mode.
  2514.           
  2515.           Alt-Q
  2516.           
  2517.                This tells BinkleyTerm to quit the current event, and start
  2518.                the next event that covers the current time period.  If there
  2519.                is no such event, Event 0 (the default non-event) will be
  2520.                started.  For all practical purposes, nothing happens during
  2521.                event 0, however, BinkleyTerm will still accept incoming mail. 
  2522.                The events can be restarted by the Alt-R command.
  2523.           
  2524.           Alt-W
  2525.           
  2526.                This command causes the screen to be redrawn with current
  2527.                information.  This is handy for situations such as multi-
  2528.                tasking that may have caused the BinkleyTerm screen to become
  2529.                "trashed."
  2530.           
  2531.           Alt-X
  2532.           
  2533.                This allows you to exit BinkleyTerm with errorlevel 1.  If you
  2534.                are using a batch file, it must capture and act upon the
  2535.                errorlevel properly by terminating the batch file.  Refer to
  2536.                the User's Guide section "Control" for additional information.
  2537.           
  2538.           C 
  2539.           
  2540.                This forces BinkleyTerm to look at the outbound holding area
  2541.                and determine whether anything should be sent right away.  If
  2542.                there is something that would not ordinarily be sent during
  2543.                the current event, this command will not cause it to be sent. 
  2544.                Use a manual poll for immediate sending to any system under
  2545.                any circumstances.  
  2546.           
  2547.                Note that BinkleyTerm automatically checks the outbound area
  2548.                approximately once every 10 minutes; the automated equivalent
  2549.                of this command.
  2550.           
  2551.           Esc
  2552.           
  2553.                This causes BinkleyTerm to exit to DOS and stay resident (DOS
  2554.                shell).  This is probably the most efficient method to perform
  2555.                a quick DOS command "on the fly."  Enter "EXIT" at the DOS
  2556.                prompt to return to BinkleyTerm.  BinkleyTerm will
  2557.                automatically return to the directory it was run from when
  2558.                returning from DOS.
  2559.           
  2560.           Space
  2561.           
  2562.                This key may be used to abort polls and to un-blank the screen
  2563.  
  2564.               BinkleyTerm Version 2.30 - Reference Guide - Page 46
  2565.  
  2566.                (when the 'ScreenBlank' option is used).  This key is ignored
  2567.                when pressed during BinkleyTerm idle time (waiting for calls).
  2568.           
  2569.           
  2570.           VT-100 KEYSTROKES
  2571.           
  2572.           As described in the User's Guide, BinkleyTerm can optionally
  2573.           provide complete VT-100 terminal emulation.  Part of this support
  2574.           is keystroke mapping of the VT-100 keypad.  Shown below is an
  2575.           illustration of the VT-100 keypad, and the keystrokes that are
  2576.           required in order to emulate the respective key.  The keypad layout
  2577.           and functionality should be familiar to VT-100 users. 
  2578.           
  2579.                         +--------+--------+--------+--------+
  2580.                         |        |        | Shift- | Shift- |
  2581.                         |   F1   |   F2   |   F1   |   F2   |
  2582.                         |        |        |        |        |
  2583.                         +--------+--------+--------+--------+
  2584.                         |        |        | Shift- | Shift- |
  2585.                         |   F3   |   F4   |   F3   |   F4   |
  2586.                         |        |        |        |        |
  2587.                         +--------+--------+--------+--------+
  2588.                         |        |        | Shift- | Shift- |
  2589.                         |   F5   |   F6   |   F5   |   F6   |
  2590.                         |        |        |        |        |
  2591.                         +--------+--------+--------+--------+
  2592.                         |        |        | Shift- |        |
  2593.                         |   F7   |   F8   |   F7   |        |
  2594.                         |        |        |        | Shift- |
  2595.                         +--------+--------+--------+   F10  |
  2596.                         |                 | Shift- |        |
  2597.                         |       F10       |   F9   |        |
  2598.                         |                 |        |        |
  2599.                         +-----------------+--------+--------+
  2600.           
  2601.           Note that BinkleyTerm also allows the use of the arrow cursor
  2602.           control keys on the keyboard.  When used with a host that supports
  2603.           VT-100 or ANSI, the arrow keys are functional for cursor
  2604.           positioning.  One of the more common non-VT-100 applications for
  2605.           these keys is with Opus-CBCS' "OPed" full-screen on-line message
  2606.           editor, and many of the full-screen external on-line editors used
  2607.           with QuickBBS.
  2608.           
  2609.           
  2610.  
  2611.